<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">

<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->


<meta>
      <topic id="textswriterguidetextdoc_inframexml" indexer="include" status="PUBLISH">
         <title xml-lang="en-US" id="tit">Inserting an Entire Text Document</title>
         <filename>/text/swriter/guide/textdoc_inframe.xhp</filename>
      </topic>
   </meta>
   <body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3155185"><bookmark_value>sections;inserting external content</bookmark_value>
      <bookmark_value>text documents;merging</bookmark_value>
      <bookmark_value>links;inserting text documents as</bookmark_value>
      <bookmark_value>inserting;text documents</bookmark_value>
</bookmark><comment>mw deleted "text;"</comment>
<paragraph xml-lang="en-US" id="hd_id3155185" role="heading" level="1"><variable id="textdoc_inframe"><link href="text/swriter/guide/textdoc_inframe.xhp">Inserting an Entire Text Document</link>
</variable></paragraph>
      <h2 id="hd_id1812799">To Insert a Text File</h2>
      <list type="ordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3155855" role="listitem">Place the cursor in the document where you want to insert the file.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3147412" role="listitem">Choose <menuitem>Insert - Text from File</menuitem>.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149839" role="listitem">Locate the text document that you want to insert, and then click <emph>OK</emph>.</paragraph>
         </listitem>
      </list>
      <paragraph xml-lang="en-US" id="par_id3148858" role="paragraph">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>
      <h2 id="hd_id3156105">To Insert an Entire Text Document as a Link</h2>
      <list type="ordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3150096" role="listitem">Place the cursor in the document where you want to insert the file.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3153404" role="listitem">Choose <emph>Insert - Section</emph>.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3153127" role="listitem">Type a name in the <emph>New Section</emph> box, and then select the <emph>Link</emph> check box.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149642" role="listitem">In the <item type="menuitem">File Name</item> box, type the name of the file that you want to insert, or click the <item type="menuitem">Browse</item> button and locate the file.</paragraph>
            <paragraph xml-lang="en-US" id="par_id3149968" role="listitem">If the target text document contains sections, you can select the section that you want to insert in the
               <item type="menuitem">Sections</item> box.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149619" role="listitem">If you want, set the formatting options for the section.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149862" role="listitem">Click <emph>Insert</emph>.</paragraph>
         </listitem>
      </list>
      <paragraph xml-lang="en-US" id="par_id3145099" role="paragraph">$[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>
<section id="relatedtopics">
      <embed href="text/swriter/guide/text_frame.xhp#text_frame"/>
      </section>
   </body>
</helpdocument>
