1cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?>
2*c2b55da1Smseidel
30e4b25e7SAndrew Rist<!--***********************************************************
4*c2b55da1Smseidel *
50e4b25e7SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one
60e4b25e7SAndrew Rist * or more contributor license agreements.  See the NOTICE file
70e4b25e7SAndrew Rist * distributed with this work for additional information
80e4b25e7SAndrew Rist * regarding copyright ownership.  The ASF licenses this file
90e4b25e7SAndrew Rist * to you under the Apache License, Version 2.0 (the
100e4b25e7SAndrew Rist * "License"); you may not use this file except in compliance
110e4b25e7SAndrew Rist * with the License.  You may obtain a copy of the License at
12*c2b55da1Smseidel *
130e4b25e7SAndrew Rist *   http://www.apache.org/licenses/LICENSE-2.0
14*c2b55da1Smseidel *
150e4b25e7SAndrew Rist * Unless required by applicable law or agreed to in writing,
160e4b25e7SAndrew Rist * software distributed under the License is distributed on an
170e4b25e7SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
180e4b25e7SAndrew Rist * KIND, either express or implied.  See the License for the
190e4b25e7SAndrew Rist * specific language governing permissions and limitations
200e4b25e7SAndrew Rist * under the License.
21*c2b55da1Smseidel *
220e4b25e7SAndrew Rist ***********************************************************-->
230e4b25e7SAndrew Rist
24*c2b55da1Smseidel<helpdocument version="1.0">
25cdf0e10cSrcweir<meta>
26*c2b55da1Smseidel<topic id="textswriterguideglobaldoc_howtosxml" indexer="include" status="PUBLISH">
27*c2b55da1Smseidel<title xml-lang="en-US" id="tit">Working with Master Documents and Subdocuments</title>
28*c2b55da1Smseidel<filename>/text/swriter/guide/globaldoc_howtos.xhp</filename>
29*c2b55da1Smseidel</topic>
30*c2b55da1Smseidel</meta>
31*c2b55da1Smseidel<body>
32*c2b55da1Smseidel<bookmark xml-lang="en-US" branch="index" id="bm_id3145246">
33*c2b55da1Smseidel<bookmark_value>Navigator;master documents</bookmark_value>
34*c2b55da1Smseidel<bookmark_value>master documents;creating/editing/exporting</bookmark_value>
35*c2b55da1Smseidel<bookmark_value>subdocuments;creating/editing/removing</bookmark_value>
36*c2b55da1Smseidel<bookmark_value>removing;subdocuments</bookmark_value>
37*c2b55da1Smseidel<bookmark_value>indexes; master documents</bookmark_value>
38cdf0e10cSrcweir</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>
39cdf0e10cSrcweir<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>
40cdf0e10cSrcweir</variable></paragraph><comment>MW: this is a new guide created from splitting globaldoc.xhp</comment>
41cdf0e10cSrcweir<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>
42*c2b55da1Smseidel<paragraph xml-lang="en-US" id="hd_id3153127" role="heading" level="2" l10n="U"
43*c2b55da1Smseideloldref="29">To Create a Master Document</paragraph>
44*c2b55da1Smseidel<list type="ordered">
45*c2b55da1Smseidel<listitem>
46*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3149634" role="listitem" l10n="U" oldref="30">Do one of the following:</paragraph>
47*c2b55da1Smseidel</listitem>
48*c2b55da1Smseidel</list>
49cdf0e10cSrcweir<list type="unordered">
50cdf0e10cSrcweir<listitem>
51cdf0e10cSrcweir<paragraph role="listitem" id="par_id3149956" xml-lang="en-US" l10n="U" oldref="31">Choose <emph>File - New - Master Document</emph>.</paragraph>
52cdf0e10cSrcweir</listitem>
53cdf0e10cSrcweir<listitem>
54cdf0e10cSrcweir<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>
55cdf0e10cSrcweir</listitem>
56cdf0e10cSrcweir</list>
57*c2b55da1Smseidel<list type="ordered" startwith="2">
58*c2b55da1Smseidel<listitem>
59*c2b55da1Smseidel<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> 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>
60*c2b55da1Smseidel</listitem>
61*c2b55da1Smseidel<listitem>
62*c2b55da1Smseidel<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> icon, and do one of the following:</paragraph>
63*c2b55da1Smseidel</listitem>
64*c2b55da1Smseidel</list>
65cdf0e10cSrcweir<list type="unordered">
66cdf0e10cSrcweir<listitem>
67cdf0e10cSrcweir<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>
68cdf0e10cSrcweir</listitem>
69cdf0e10cSrcweir<listitem>
70cdf0e10cSrcweir<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>
71cdf0e10cSrcweir</listitem>
72cdf0e10cSrcweir<listitem>
73cdf0e10cSrcweir<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>
74cdf0e10cSrcweir</listitem>
75cdf0e10cSrcweir</list>
76*c2b55da1Smseidel<list type="ordered" startwith="4">
77*c2b55da1Smseidel<listitem>
78*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3153382" role="listitem" l10n="U" oldref="36">Choose <emph>File - Save</emph>.</paragraph>
79*c2b55da1Smseidel</listitem>
80*c2b55da1Smseidel</list>
81*c2b55da1Smseidel<paragraph xml-lang="en-US" id="hd_id3154242" role="heading" level="2" l10n="U"
82*c2b55da1Smseideloldref="37">To Edit a Master Document</paragraph>
83*c2b55da1Smseidel<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>
84*c2b55da1Smseidel<list type="unordered">
85*c2b55da1Smseidel<listitem>
86*c2b55da1Smseidel<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>
87*c2b55da1Smseidel</listitem>
88*c2b55da1Smseidel</list>
89*c2b55da1Smseidel<list type="unordered">
90*c2b55da1Smseidel<listitem>
91*c2b55da1Smseidel<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>
92*c2b55da1Smseidel</listitem>
93*c2b55da1Smseidel</list>
94*c2b55da1Smseidel<list type="unordered">
95*c2b55da1Smseidel<listitem>
96*c2b55da1Smseidel<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>
97*c2b55da1Smseidel</listitem>
98*c2b55da1Smseidel</list>
99*c2b55da1Smseidel<list type="unordered">
100*c2b55da1Smseidel<listitem>
101*c2b55da1Smseidel<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> icon.</paragraph>
102*c2b55da1Smseidel</listitem>
103*c2b55da1Smseidel</list>
104*c2b55da1Smseidel<list type="unordered">
105*c2b55da1Smseidel<listitem>
106*c2b55da1Smseidel<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>
107*c2b55da1Smseidel</listitem>
108*c2b55da1Smseidel</list>
109*c2b55da1Smseidel<table id="tbl_id3154206">
110*c2b55da1Smseidel<tablerow>
111*c2b55da1Smseidel<tablecell>
112*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3148949" role="paragraph" l10n="E">
113cdf0e10cSrcweir<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>
114*c2b55da1Smseidel</image></paragraph>
115*c2b55da1Smseidel</tablecell>
116*c2b55da1Smseidel<tablecell>
117*c2b55da1Smseidel<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>
118*c2b55da1Smseidel</tablecell>
119*c2b55da1Smseidel</tablerow>
120*c2b55da1Smseidel</table>
121*c2b55da1Smseidel<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>
122*c2b55da1Smseidel<paragraph xml-lang="en-US" id="hd_id3153656" role="heading" level="3" l10n="U"
123*c2b55da1Smseideloldref="41">To Start Each Subdocument on a New Page</paragraph>
124*c2b55da1Smseidel<list type="ordered">
125*c2b55da1Smseidel<listitem>
126*c2b55da1Smseidel<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>
127*c2b55da1Smseidel</listitem>
128*c2b55da1Smseidel<listitem>
129*c2b55da1Smseidel<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>
130*c2b55da1Smseidel</listitem>
131*c2b55da1Smseidel<listitem>
132*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3153907" role="listitem" l10n="U" oldref="44">Right-click "Heading 1" and choose <emph>Modify</emph>.</paragraph>
133*c2b55da1Smseidel</listitem>
134*c2b55da1Smseidel<listitem>
135*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3147124" role="listitem" l10n="U" oldref="45">Click the <item type="menuitem">Text Flow</item> tab.</paragraph>
136*c2b55da1Smseidel</listitem>
137*c2b55da1Smseidel<listitem>
138*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3149770" role="listitem" l10n="CHG" oldref="46">In the <item type="menuitem">Breaks</item> area, select <item type="menuitem">Insert</item>, and then select “Page” in the <item type="menuitem">Type</item> box.</paragraph>
139*c2b55da1Smseidel</listitem>
140*c2b55da1Smseidel<listitem>
141*c2b55da1Smseidel<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>
142*c2b55da1Smseidel</listitem>
143*c2b55da1Smseidel<listitem>
144*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3145205" role="listitem" l10n="U" oldref="47">Click <emph>OK</emph>.</paragraph>
145*c2b55da1Smseidel</listitem>
146*c2b55da1Smseidel</list>
147*c2b55da1Smseidel<paragraph xml-lang="en-US" id="hd_id3145228" role="heading" level="3" l10n="CHG"
148*c2b55da1Smseideloldref="48">To Export a Master Document as a <item type="productname">%PRODUCTNAME</item> Text Document</paragraph>
149*c2b55da1Smseidel<list type="ordered">
150*c2b55da1Smseidel<listitem>
151*c2b55da1Smseidel<paragraph xml-lang="en-US" id="par_id3150315" role="listitem" l10n="U" oldref="49">Choose <item type="menuitem">File - Export</item>.</paragraph>
152*c2b55da1Smseidel</listitem>
153*c2b55da1Smseidel<listitem>
154*c2b55da1Smseidel<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>
155*c2b55da1Smseidel</listitem>
156*c2b55da1Smseidel</list>
157*c2b55da1Smseidel<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>
158*c2b55da1Smseidel<section id="relatedtopics">
159*c2b55da1Smseidel<embed href="text/swriter/guide/indices_multidoc.xhp#indices_multidoc"/>
160*c2b55da1Smseidel<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>
161*c2b55da1Smseidel</section>
162*c2b55da1Smseidel</body>
163cdf0e10cSrcweir</helpdocument>
164