1*b1cdbd2cSJim Jagielski<?xml version="1.0" encoding="UTF-8"?>
2*b1cdbd2cSJim Jagielski<helpdocument version="1.0">
3*b1cdbd2cSJim Jagielski
4*b1cdbd2cSJim Jagielski<!--***********************************************************
5*b1cdbd2cSJim Jagielski *
6*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one
7*b1cdbd2cSJim Jagielski * or more contributor license agreements.  See the NOTICE file
8*b1cdbd2cSJim Jagielski * distributed with this work for additional information
9*b1cdbd2cSJim Jagielski * regarding copyright ownership.  The ASF licenses this file
10*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the
11*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance
12*b1cdbd2cSJim Jagielski * with the License.  You may obtain a copy of the License at
13*b1cdbd2cSJim Jagielski *
14*b1cdbd2cSJim Jagielski *   http://www.apache.org/licenses/LICENSE-2.0
15*b1cdbd2cSJim Jagielski *
16*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing,
17*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an
18*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19*b1cdbd2cSJim Jagielski * KIND, either express or implied.  See the License for the
20*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations
21*b1cdbd2cSJim Jagielski * under the License.
22*b1cdbd2cSJim Jagielski *
23*b1cdbd2cSJim Jagielski ***********************************************************-->
24*b1cdbd2cSJim Jagielski
25*b1cdbd2cSJim Jagielski
26*b1cdbd2cSJim Jagielski
27*b1cdbd2cSJim Jagielski
28*b1cdbd2cSJim Jagielski<meta>
29*b1cdbd2cSJim Jagielski      <topic id="textswriterguideglobaldoc_howtosxml" indexer="include" status="PUBLISH">
30*b1cdbd2cSJim Jagielski         <title xml-lang="en-US" id="tit">Working with Master Documents and Subdocuments</title>
31*b1cdbd2cSJim Jagielski         <filename>/text/swriter/guide/globaldoc_howtos.xhp</filename>
32*b1cdbd2cSJim Jagielski      </topic>
33*b1cdbd2cSJim Jagielski   </meta>
34*b1cdbd2cSJim Jagielski   <body>
35*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="index" id="bm_id3145246"><bookmark_value>Navigator;master documents</bookmark_value>
36*b1cdbd2cSJim Jagielski      <bookmark_value>master documents;creating/editing/exporting</bookmark_value>
37*b1cdbd2cSJim Jagielski      <bookmark_value>subdocuments;creating/editing/removing</bookmark_value>
38*b1cdbd2cSJim Jagielski      <bookmark_value>removing;subdocuments</bookmark_value>
39*b1cdbd2cSJim Jagielski      <bookmark_value>indexes; master documents</bookmark_value>
40*b1cdbd2cSJim Jagielski</bookmark><comment>MW created 4 new index entries. 2 index entries were taken from globaldoc.xhp.</comment><comment>MW made one index entry out of 2 "subdocuments;" entries</comment>
41*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="hd_id3145246" role="heading" level="1" l10n="U" oldref="4"><variable id="globaldoc_howtos"><link href="text/swriter/guide/globaldoc_howtos.xhp">Working with Master Documents and Subdocuments</link>
42*b1cdbd2cSJim Jagielski</variable></paragraph><comment>MW: this is a new guide created from splitting globaldoc.xhp</comment>
43*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_id1522873" role="paragraph" l10n="NEW">A master document lets you manage large documents, such as a book with many chapters. The master document can be seen as a container for individual <item type="productname">%PRODUCTNAME</item> Writer files. The individual files are called subdocuments.</paragraph>
44*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="hd_id3153127" role="heading" level="2" l10n="U"
45*b1cdbd2cSJim Jagielski                 oldref="29">To Create a Master Document</paragraph>
46*b1cdbd2cSJim Jagielski      <list type="ordered">
47*b1cdbd2cSJim Jagielski         <listitem>
48*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3149634" role="listitem" l10n="U" oldref="30">Do one of the following:</paragraph>
49*b1cdbd2cSJim Jagielski         </listitem>
50*b1cdbd2cSJim Jagielski      </list>
51*b1cdbd2cSJim Jagielski
52*b1cdbd2cSJim Jagielski
53*b1cdbd2cSJim Jagielski
54*b1cdbd2cSJim Jagielski<list type="unordered">
55*b1cdbd2cSJim Jagielski<listitem>
56*b1cdbd2cSJim Jagielski<paragraph role="listitem" id="par_id3149956" xml-lang="en-US" l10n="U" oldref="31">Choose <emph>File - New - Master Document</emph>.</paragraph>
57*b1cdbd2cSJim Jagielski</listitem>
58*b1cdbd2cSJim Jagielski
59*b1cdbd2cSJim Jagielski<listitem>
60*b1cdbd2cSJim Jagielski<paragraph role="listitem" id="par_id3149612" xml-lang="en-US" l10n="U" oldref="32">Open an existing document and choose <emph>File - Send - Create Master Document</emph>.</paragraph>
61*b1cdbd2cSJim Jagielski</listitem>
62*b1cdbd2cSJim Jagielski</list>
63*b1cdbd2cSJim Jagielski
64*b1cdbd2cSJim Jagielski
65*b1cdbd2cSJim Jagielski
66*b1cdbd2cSJim Jagielski
67*b1cdbd2cSJim Jagielski      <list type="ordered" startwith="2">
68*b1cdbd2cSJim Jagielski         <listitem>
69*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3149873" role="listitem" l10n="CHG" oldref="28">If you are creating a new master document, the first entry in the Navigator should be a <item type="menuitem">Text</item>
70*b1cdbd2cSJim Jagielski               <emph/>entry. Type an introduction or enter some text. This ensures that after having edited an existing style in the master document, you see the changed style when viewing the subdocuments.</paragraph>
71*b1cdbd2cSJim Jagielski         </listitem>
72*b1cdbd2cSJim Jagielski         <listitem>
73*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3145114" role="listitem" l10n="CHG" oldref="33">In the <item type="menuitem">Navigator</item> for master documents (should open automatically, else press F5 to open), click and hold the <item type="menuitem">Insert</item>
74*b1cdbd2cSJim Jagielski               <emph/>icon, and do one of the following:</paragraph>
75*b1cdbd2cSJim Jagielski         </listitem>
76*b1cdbd2cSJim Jagielski      </list>
77*b1cdbd2cSJim Jagielski
78*b1cdbd2cSJim Jagielski<list type="unordered">
79*b1cdbd2cSJim Jagielski<listitem>
80*b1cdbd2cSJim Jagielski<paragraph role="listitem" id="par_id3156240" xml-lang="en-US" l10n="U" oldref="34">To insert an existing file as a subdocument, choose <emph>File</emph>, locate the file that you want to include, and then click <emph>OK</emph>.</paragraph>
81*b1cdbd2cSJim Jagielski</listitem>
82*b1cdbd2cSJim Jagielski
83*b1cdbd2cSJim Jagielski<listitem>
84*b1cdbd2cSJim Jagielski<paragraph role="listitem" id="par_id3145405" xml-lang="en-US" l10n="U" oldref="35">To create a new subdocument, choose <emph>New Document</emph>, type a name for the file, and then click <emph>Save</emph>.</paragraph>
85*b1cdbd2cSJim Jagielski</listitem>
86*b1cdbd2cSJim Jagielski<listitem>
87*b1cdbd2cSJim Jagielski<paragraph role="listitem" id="par_id8550981" xml-lang="en-US" l10n="CHG">To insert some text between subdocuments, choose <emph>Text</emph>. Then type the text. You cannot insert text next to an existing text entry in the Navigator.<comment>i81372</comment></paragraph>
88*b1cdbd2cSJim Jagielski</listitem>
89*b1cdbd2cSJim Jagielski</list>
90*b1cdbd2cSJim Jagielski
91*b1cdbd2cSJim Jagielski
92*b1cdbd2cSJim Jagielski      <list type="ordered" startwith="4">
93*b1cdbd2cSJim Jagielski         <listitem>
94*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3153382" role="listitem" l10n="U" oldref="36">Choose <emph>File - Save</emph>.</paragraph>
95*b1cdbd2cSJim Jagielski         </listitem>
96*b1cdbd2cSJim Jagielski      </list>
97*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="hd_id3154242" role="heading" level="2" l10n="U"
98*b1cdbd2cSJim Jagielski                 oldref="37">To Edit a Master Document</paragraph>
99*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_id3154255" role="paragraph" l10n="U" oldref="20">Use the Navigator for rearranging and editing the subdocuments in a master document.</paragraph>
100*b1cdbd2cSJim Jagielski      <list type="unordered">
101*b1cdbd2cSJim Jagielski         <listitem>
102*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3155879" role="listitem" l10n="CHG" oldref="38">To open a subdocument for editing, double-click the name of the subdocument in the Navigator.</paragraph>
103*b1cdbd2cSJim Jagielski         </listitem>
104*b1cdbd2cSJim Jagielski      </list>
105*b1cdbd2cSJim Jagielski      <list type="unordered">
106*b1cdbd2cSJim Jagielski         <listitem>
107*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3155931" role="listitem" l10n="CHG" oldref="39">To remove a subdocument from the master document, right-click the subdocument in the Navigator list and choose <emph>Delete</emph>. The subdocument file is not deleted, only the entry in the Navigator is removed.</paragraph>
108*b1cdbd2cSJim Jagielski         </listitem>
109*b1cdbd2cSJim Jagielski      </list>
110*b1cdbd2cSJim Jagielski      <list type="unordered">
111*b1cdbd2cSJim Jagielski         <listitem>
112*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3148677" role="listitem" l10n="CHG" oldref="8">To add text to a master document, right-click an item in the Navigator list, and then choose <emph>Insert - Text</emph>. A text section is inserted before the selected item in the master document where you can type the text that you want. You cannot insert text next to an existing text entry in the Navigator.<comment>i81372</comment></paragraph>
113*b1cdbd2cSJim Jagielski         </listitem>
114*b1cdbd2cSJim Jagielski      </list>
115*b1cdbd2cSJim Jagielski      <list type="unordered">
116*b1cdbd2cSJim Jagielski         <listitem>
117*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3149982" role="listitem" l10n="U" oldref="10">To reorder the subdocuments in a master document, drag a subdocument to a new location in the Navigator list. You can also select a subdocument in the list, and click the <item type="menuitem">Move down</item> or <item type="menuitem">Move up</item>
118*b1cdbd2cSJim Jagielski               <emph/>icon.</paragraph>
119*b1cdbd2cSJim Jagielski         </listitem>
120*b1cdbd2cSJim Jagielski      </list>
121*b1cdbd2cSJim Jagielski      <list type="unordered">
122*b1cdbd2cSJim Jagielski         <listitem>
123*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3153022" role="listitem" l10n="CHG" oldref="40">To add an index, such as a table of contents, right-click in the Navigator list, and then choose <emph>Insert - Index</emph>.</paragraph>
124*b1cdbd2cSJim Jagielski         </listitem>
125*b1cdbd2cSJim Jagielski      </list>
126*b1cdbd2cSJim Jagielski      <table id="tbl_id3154206">
127*b1cdbd2cSJim Jagielski         <tablerow>
128*b1cdbd2cSJim Jagielski            <tablecell>
129*b1cdbd2cSJim Jagielski               <paragraph xml-lang="en-US" id="par_id3148949" role="paragraph" l10n="E">
130*b1cdbd2cSJim Jagielski<image id="img_id3148959" src="sw/imglst/sc20246.png" width="0.1862in" height="0.1862in"><alt xml-lang="en-US" id="alt_id3148959">Icon</alt>
131*b1cdbd2cSJim Jagielski	</image></paragraph>
132*b1cdbd2cSJim Jagielski            </tablecell>
133*b1cdbd2cSJim Jagielski            <tablecell>
134*b1cdbd2cSJim Jagielski               <paragraph xml-lang="en-US" id="par_id3153632" role="paragraph" l10n="U" oldref="21">To update an index in a master document, select the index in the Navigator, and then click the <emph>Update</emph> icon.</paragraph>
135*b1cdbd2cSJim Jagielski            </tablecell>
136*b1cdbd2cSJim Jagielski         </tablerow>
137*b1cdbd2cSJim Jagielski      </table>
138*b1cdbd2cSJim Jagielski
139*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN10C40" role="note" l10n="NEW">When you insert an object like a frame or a picture into a master document, do not anchor the object "to page". Instead, set the anchor "to paragraph" on the <emph>Format - (Object type) - Type</emph> tab page, and then set the object's position relative to "Entire Page" in the <emph>Horizontal</emph> and <emph>Vertical</emph> list boxes.</paragraph>
140*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="hd_id3153656" role="heading" level="3" l10n="U"
141*b1cdbd2cSJim Jagielski                 oldref="41">To Start Each Subdocument on a New Page</paragraph>
142*b1cdbd2cSJim Jagielski      <list type="ordered">
143*b1cdbd2cSJim Jagielski         <listitem>
144*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3152760" role="listitem" l10n="U" oldref="42">Ensure that each subdocument starts with a heading that uses the same paragraph style, for example "Heading 1".</paragraph>
145*b1cdbd2cSJim Jagielski         </listitem>
146*b1cdbd2cSJim Jagielski         <listitem>
147*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3153876" role="listitem" l10n="U" oldref="43">In the master document, choose <emph>Format - Styles and Formatting</emph>, and click the <emph>Paragraph Styles</emph> icon.</paragraph>
148*b1cdbd2cSJim Jagielski         </listitem>
149*b1cdbd2cSJim Jagielski         <listitem>
150*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3153907" role="listitem" l10n="U" oldref="44">Right-click "Heading 1" and choose <emph>Modify</emph>.</paragraph>
151*b1cdbd2cSJim Jagielski         </listitem>
152*b1cdbd2cSJim Jagielski         <listitem>
153*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3147124" role="listitem" l10n="U" oldref="45">Click the <item type="menuitem">Text Flow</item>
154*b1cdbd2cSJim Jagielski               <emph/>tab.</paragraph>
155*b1cdbd2cSJim Jagielski         </listitem>
156*b1cdbd2cSJim Jagielski         <listitem>
157*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3149770" role="listitem" l10n="CHG" oldref="46">In the <item type="menuitem">Breaks</item>
158*b1cdbd2cSJim Jagielski               <emph/>area, select <item type="menuitem">Insert</item>, and then select “Page”<emph/>in the <item type="menuitem">Type</item>
159*b1cdbd2cSJim Jagielski               <emph/>box.</paragraph>
160*b1cdbd2cSJim Jagielski         </listitem>
161*b1cdbd2cSJim Jagielski         <listitem>
162*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3150224" role="listitem" l10n="U" oldref="17">If you want each subdocument to start on an odd page, select <emph>With Page Style</emph>, and select "Right page" in the box.</paragraph>
163*b1cdbd2cSJim Jagielski         </listitem>
164*b1cdbd2cSJim Jagielski         <listitem>
165*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3145205" role="listitem" l10n="U" oldref="47">Click <emph>OK</emph>.</paragraph>
166*b1cdbd2cSJim Jagielski         </listitem>
167*b1cdbd2cSJim Jagielski      </list>
168*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="hd_id3145228" role="heading" level="3" l10n="CHG"
169*b1cdbd2cSJim Jagielski                 oldref="48">To Export a Master Document as a <item type="productname">%PRODUCTNAME</item> Text Document</paragraph>
170*b1cdbd2cSJim Jagielski      <list type="ordered">
171*b1cdbd2cSJim Jagielski         <listitem>
172*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3150315" role="listitem" l10n="U" oldref="49">Choose <item type="menuitem">File - Export</item>.</paragraph>
173*b1cdbd2cSJim Jagielski         </listitem>
174*b1cdbd2cSJim Jagielski         <listitem>
175*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id3148580" role="listitem" l10n="U" oldref="50">In the <emph>File format</emph> list, select a text document file format and click <emph>Export</emph>.</paragraph>
176*b1cdbd2cSJim Jagielski         </listitem>
177*b1cdbd2cSJim Jagielski      </list>
178*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_id8371227" role="note" l10n="NEW">The subdocuments will be exported as sections. Use <item type="menuitem">Format - Sections</item> to unprotect and remove sections, if you prefer a plain text document without sections.</paragraph>
179*b1cdbd2cSJim Jagielski      <section id="relatedtopics">
180*b1cdbd2cSJim Jagielski         <embed href="text/swriter/guide/indices_multidoc.xhp#indices_multidoc"/>
181*b1cdbd2cSJim Jagielski         <paragraph xml-lang="en-US" id="par_id3154382" role="paragraph" l10n="C"><link href="text/shared/01/02110000.xhp" name="Navigator in master mode">Navigator in master mode</link></paragraph>
182*b1cdbd2cSJim Jagielski      </section>
183*b1cdbd2cSJim Jagielski   </body>
184*b1cdbd2cSJim Jagielski</helpdocument>
185