1<?xml version="1.0" encoding="UTF-8"?>
2<helpdocument version="1.0">
3
4<!--***********************************************************
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements.  See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership.  The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License.  You may obtain a copy of the License at
13 *
14 *   http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied.  See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 ***********************************************************-->
24
25
26
27
28<meta>
29      <topic id="textswriterguidetextdoc_inframexml" indexer="include" status="PUBLISH">
30         <title xml-lang="en-US" id="tit">Inserting an Entire Text Document</title>
31         <filename>/text/swriter/guide/textdoc_inframe.xhp</filename>
32      </topic>
33   </meta>
34   <body>
35<bookmark xml-lang="en-US" branch="index" id="bm_id3155185"><bookmark_value>sections;inserting external content</bookmark_value>
36      <bookmark_value>text documents;merging</bookmark_value>
37      <bookmark_value>links;inserting text documents as</bookmark_value>
38      <bookmark_value>inserting;text documents</bookmark_value>
39</bookmark><comment>mw deleted "text;"</comment>
40<paragraph xml-lang="en-US" id="hd_id3155185" role="heading" level="1" l10n="U"
41                 oldref="23"><variable id="textdoc_inframe"><link href="text/swriter/guide/textdoc_inframe.xhp" name="Inserting an Entire Text Document">Inserting an Entire Text Document</link>
42</variable></paragraph>
43      <paragraph xml-lang="en-US" id="hd_id1812799" role="heading" level="2" l10n="NEW">To Insert a Text File</paragraph>
44      <list type="ordered">
45         <listitem>
46            <paragraph xml-lang="en-US" id="par_id3155855" role="listitem" l10n="U" oldref="28">Place the cursor in the document where you want to insert the file.</paragraph>
47         </listitem>
48         <listitem>
49            <paragraph xml-lang="en-US" id="par_id3147412" role="listitem" l10n="U" oldref="30">Choose <emph>Insert - File</emph>.</paragraph>
50         </listitem>
51         <listitem>
52            <paragraph xml-lang="en-US" id="par_id3149839" role="listitem" l10n="U" oldref="31">Locate the text document that you want to insert, and then click <emph>OK</emph>.</paragraph>
53         </listitem>
54      </list>
55      <paragraph xml-lang="en-US" id="par_id3148858" role="paragraph" l10n="U" oldref="32">The contents of the text document are embedded into the current document and are not updated if the source file is changed. If you want the contents to automatically update when you change the source document, insert the file as a link.</paragraph>
56      <paragraph xml-lang="en-US" id="hd_id3156105" role="heading" level="2" l10n="U"
57                 oldref="33">To Insert an Entire Text Document as a Link</paragraph>
58      <list type="ordered">
59         <listitem>
60            <paragraph xml-lang="en-US" id="par_id3150096" role="listitem" l10n="U" oldref="34">Place the cursor in the document where you want to insert the file.</paragraph>
61         </listitem>
62         <listitem>
63            <paragraph xml-lang="en-US" id="par_id3153404" role="listitem" l10n="U" oldref="35">Choose <emph>Insert - Section</emph>.</paragraph>
64         </listitem>
65         <listitem>
66            <paragraph xml-lang="en-US" id="par_id3153127" role="listitem" l10n="U" oldref="36">Type a name in the <emph>New Section</emph> box, and then select the <emph>Link</emph> check box.</paragraph>
67         </listitem>
68         <listitem>
69            <paragraph xml-lang="en-US" id="par_id3149642" role="listitem" l10n="U" oldref="37">In the <item type="menuitem">File Name</item>
70               <emph/>box, type the name of the file that you want to insert, or click the browse button (<item type="menuitem">...</item>) and locate the file.</paragraph>
71            <paragraph xml-lang="en-US" id="par_id3149968" role="listitem" l10n="U" oldref="38">If the target text document contains sections, you can select the section that you want to insert in the<emph/>
72               <item type="menuitem">Sections</item> box.</paragraph>
73         </listitem>
74         <listitem>
75            <paragraph xml-lang="en-US" id="par_id3149619" role="listitem" l10n="U" oldref="39">If you want, set the formatting options for the section.</paragraph>
76         </listitem>
77         <listitem>
78            <paragraph xml-lang="en-US" id="par_id3149862" role="listitem" l10n="U" oldref="40">Click <emph>Insert</emph>.</paragraph>
79         </listitem>
80      </list>
81      <paragraph xml-lang="en-US" id="par_id3145099" role="paragraph" l10n="U" oldref="41">$[officename] automatically updates the contents of the inserted section whenever the source document is changed. To manually update the contents of the section, choose <emph>Tools - Update - Update All</emph>.</paragraph>
82      <embed href="text/shared/00/00000004.xhp#related"/>
83      <embed href="text/swriter/guide/text_frame.xhp#text_frame"/>
84   </body>
85</helpdocument>