# Master Documents and Subdocuments

/text/swriter/guide/globaldoc.xhp
master documents;properties
subdocuments;properties
central documents
subsidiary documents
documents; master documents and subdocuments
styles;master documents
Mw made "master documents" and "subdocuments" a two level entry, deleted "references;" and "bookmarks;" and added a new entry and shifted "Navigator;" and "indexes;" to the file globaldoc_howtos.xhp
Master Documents and Subdocuments
MW: This file was split into globaldoc.xhp (concepts) and globaldoc_howtos.xhp (procedures)
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 %PRODUCTNAME Writer files. The individual files are called subdocuments.
Characteristics of Master Documents
- When you print a master document, the contents of all subdocuments, indexes, and any text that you entered are printed.
- You can create a table of contents and index in the master document for all of the subdocuments.
- Styles that are used in subdocuments, such as new paragraph styles, are automatically imported into the master document.
- When viewing the master document, styles that are already present in the master document take precedence over styles with the same name that are imported from subdocuments.
- Subdocuments never get changed by changes made to the master document.
When you add a document to a master document or create a new subdocument, a link is created in the master document. You cannot edit the content of a subdocument directly in the master document, but you can use the Navigator to open any subdocument for edit.
Example of Using Styles
A master document master.odm consists of some text and links to the subdocuments sub1.odt and sub2.odt. In each subdocument a new paragraph style with the same name Style1 is defined and used, and the subdocuments are saved.
When you save the master document, the styles from the subdocuments are imported into the master document. First, the new style Style1 from the sub1.odt is imported. Next, the new styles from sub2.odt will be imported, but as Style1 now already is present in the master document, this style from sub2.odt will not be imported.
In the master document you now see the new style Style1 from the first subdocument. All Style1 paragraphs in the master document will be shown using the Style1 attributes from the first subdocument. However, the second subdocument by itself will not be changed. You see the Style1 paragraphs from the second subdocument with different attributes, depending whether you open the sub2.odt document by itself or as part of the master document.
To avoid confusion, use the same document template for the master document and its subdocuments. This happens automatically when you create the master document and its subdocuments from an existing document with headings, using the command File - Send - Create Master Document.
Navigator in master mode