Cross-references in a Master Document

From NeoWiki

(Difference between revisions)

Current revision

1 Description of the Problem
- 1.1 More Concretely...
2 Procedure
- 2.1 Procedure for the Creation of a "Global" Reference

Description of the Problem

Let's say that a sub-document (an inserted document) of a master document must contain a cross-reference to an element in another sub-document in the same master document. In the case, it is not possible to use the Fields window to define and insert the refrence in the "traditional" manner.

More Concretely...

Let's say that the master document contains a sub-document with an outline detailing the contents of other documents. Sort of like a table of contents, but more detailed.

In this sub-document, we want the page numbers to appear, similar to a table of contents. For example, we might have the phrase "I discuss the relationship between dolphins and seals (page X)." This "X" must correspond to a page in another sub-document of the master document (it does not matter if the other sub-document is above or below the current one). Because the document is in the process of being written, I do not know what page will be the first page of my chapter on the relationship between dophins and seals. If there is only one reference in my document, I could keep it up to date manually, but then I would be treating my computer like a typewriter.

In this case, it is best to use a reference I call a global reference. Thanks to this reference, the page number will be updated with each change to the page.

Procedure

Since an illustration is more helpful than a long discourse, the following is an example of the technique;

My master document contains a sub-document named dolphins_and_seals.odt<tt> containing a chapter titled "The Relationship Between Dolphins and Seals."
my master document contains another sub-document, named <tt>outline.odt<tt> that contains the line "I discuss the relationship between dolphinis and seals (page X)."
I want want the number (X) in "page X" to always refer to the page number of my chapter on the relationship between dolphiins and seals, regardless of any changes I make in the document.

Procedure for the Creation of a "Global" Reference To create and use this global reference, follow the three steps below: Step One: Defining the Reference It is assumed that a master document has been created, which contains a sub-document <tt>abstract.odt<tt>and the sub-document <tt>dolphins_and_seals.odt. Action Operation/Result Shortcut 1. Edit the sub-documents dolphins_and_seals.odt In the Navigator, in the section "Links," double-click on the sub document dolphins_and_seals.odt --- â€”> NeoOffice opens the document dolphins_and_seals.odt and places it in front. 2. Select the Text of the Reference In this document, select the title "Relationship between dolphins and seals." (or simply place the cursor at the beginning of this title.) --- 3. Open the Fields Window. Under the Insert menu, choose Fields then Other.... --- â€”> NeoOffice opens the Fields dialog 4. Choose the Tab Choose the References tab --- 5. Set the Reference In the left column, select "Set Reference" In the Name (in the bottom right of the dialog box), give a name to this reference, here "relDolphinsSeals" Attention ! Make a note of the name that you have given to this reference, because it will not appear later! Tip: select the name of the reference using the mouse, the copy it (Command-c). The name will now be on the clipboard; then you can paste it (Command-v) 6. Insert the definition of the reference Click on the Insert button... ... then close the Fields dialog box by clicking close. â€”> NeoOffice closes the Fields dialog box after creating the (invisible) reference. 7. Save the Document Save the document dolphins_and_seals.odt (And close it, if you do not have other edits to make in it). Command-s (then Command-w) Step Two: Using the Reference Action Operation/Result Short-cut 8. Open the sub-document outline.odt Bring the master document to the front and double-click on the link to the dub-document outline.odtin the Navigator. â€”> NeoOffice opens the document outline.odt and/or brings it to the front. 9. Choose the place where the reference needs to be Select the "X" described above, which appears in the sentence "I will discuss the relationship between dolphins and seals below (pags X). 10. Open the Fields window Under the Insert menu, choose Fields then Other... --- â€”> NeoOffice opens the Fields dialog box 11. Choose the Tab Choose the References tab if necessary (if you have followed this procedure to the letter, the tab will already be active.) --- 12. Prepare the Reference In the left-hand column, choose Insert Reference In the Name field (at the bottom right of the dialog box), type the exact name that you have given to the reference, here "relDolphinsSeals" â€” or press Command-v If you copied the name to the clipboard. 13. Format the Reference In the right column Format, make sure that Page is selected (because we want the page number where the paragraph is found). 14. Insert the Reference Insert}]... then close the Fields dialog and click on Close. Press Return â€”> NeoOffice closes the Fields diialog box after inserting the reference in the desired place. For the moment, the text must be (page 1), which is normal because the document has not yet found the definition of this reference. 15. Save the Sub-document Save the document â€¦ and close it if you do not need to make any other changes. Command-s (and Command-w) Step Three: Verify the Reference Action Operation / Result Shortcuts 16. Verification Bring the master document to the front and update the links by clicking on this icon in the Navigator; hold down the mouse button and choose "All" from the contextual menu. Confirm that this is what you want to do in the confirmation box that opens. â€”> If you have followed these instructions to the letter, you will now see, in your document <tt>outline.odt the correct page number for your chapter on the relationship between dolphins and seals. Finally, because we have been speaking about it, can you tell me about this famous relationship between dolphins and seals?... This article in other languages: Italiano FranÃ§ais Retrieved from "https://neowiki.neooffice.org/index.php/Cross-references_in_a_Master_Document" Categories: NeoOffice | Tips and Hints

-{{InTranslation}}
 ==Description of the Problem==
-Lets say that a sub-document (an inserted document) of a master document must contain a [[Cross-references in NeoOffice Writer|cross-reference]] to an element in another sub-document in the same master document.  In the case, it is not possible to use the {{Window|Fields}} window to define and insert the refrence in the "traditional" manner.
+Let's say that a sub-document (an inserted document) of a master document must contain a [[Cross-references in NeoOffice Writer|cross-reference]] to an element in another sub-document in the same master document.  In the case, it is not possible to use the {{Window|Fields}} window to define and insert the refrence in the "traditional" manner.
 <!--==Description de l'astuce==
 ===More Concretely...===
-Let's say that the master document contains a sub-document that details the contents of other documents.  Sort of like a table of contents, but more detailed.
+Let's say that the master document contains a sub-document with an outline detailing the contents of other documents.  Sort of like a table of contents, but more detailed.
-In this sub-document, we want the page numbers to appear, similar to a table of contents.  For example, we might have the phrase "I discuss the relationship between dolphins and seals below (page X)."  This "X" must correspond to a page in another sub-document of the master document (it does not matter if the other sub-document is above or below the current one).  Because the document is in the process of being written, I do not know what page will be the first page of my chapter on the relationship between dophins and seals.  If there is only one '''reference''' in my document, I could keep it up to date manually, then I would be treating my computer like a typewriter.
+In this sub-document, we want the page numbers to appear, similar to a table of contents.  For example, we might have the phrase "I discuss the relationship between dolphins and seals (page X)."  This "X" must correspond to a page in another sub-document of the master document (it does not matter if the other sub-document is above or below the current one).  Because the document is in the process of being written, I do not know what page will be the first page of my chapter on the relationship between dophins and seals.  If there is only one '''reference''' in my document, I could keep it up to date manually, but then I would be treating my computer like a typewriter.
 In this case, it is best to use a reference I call a '''global reference.'''  Thanks to this reference, the page number will be updated with each change to the page.
 *My master document contains a sub-document named <tt>dolphins_and_seals.odt<tt> containing a chapter titled "The Relationship Between Dolphins and Seals."
-*my master document contains another sub-document, named <tt>abstract.odt<tt> that contains the line "I discuss the relationship between dolphinis and seals below (page X)."
+*my master document contains another sub-document, named <tt>outline.odt<tt> that contains the line "I discuss the relationship between dolphinis and seals (page X)."
 *I want want the number (X) in "page X" to always refer to the page number of my chapter on the relationship between dolphiins and seals, regardless of any changes I make in the document.
  | ---
  |--------------------------------------------------------
- |'''3. Open the {{Window|Fields}}'''
+ |'''3. Open the {{Window|Fields}} Window.'''
  |Under the {{Menu|Insert}} menu, choose {{Menu|Fields}} then {{Menu|Other....}}
  | ---
  | ---
  |--------------------------------------------------------
- |'''5. Define the Reference'''
+ |'''5. Set the Reference'''
- |In the left column, select "Define a Reference"<br />In the {{prefName|Name}} (in the bottom right of the dialog box), give a name to this reference, here <tt>"relDolphinsSeals"</tt>
+ |In the left column, select "Set Reference"<br />In the {{prefName|Name}} (in the bottom right of the dialog box), give a name to this reference, here <tt>"relDolphinsSeals"</tt>
  |---
  |--------------------------------------------------------
  | Command-s (then Command-w)
  |}
 <!--====PremiÃ¨re Ã©tape : DÃ‰FINITION DE LA RÃ‰FÃ‰RENCE====
  |Enregistrer le document <tt>dauphins_et_phoques.sxw</tt><br />(Et fermez-le si vous n'avez pas d'autres modification Ã  faire dessus).
  | Pomme-s (puis Pomme-w)
+ |}-->
+====Step Two: Using the Reference====
+{| cellspacing="8" cellpadding="0" width="100%"
+ !width="180" align="left"|''Action''
+ !width="*" align="left"  |''Operation/Result''
+ !width="80" align="left" |''Short-cut''
+ |--------------------------------------------------------
+ |'''8. Open the sub-document <tt>outline.odt</tt>'''
+ |Bring the master document to the front and double-click on the link to the dub-document <tt>outline.odt</tt>in the Navigator.
+ |---
+ |--------------------------------------------------------
+ | ||colspan="2"|''â€”> NeoOffice opens the document <tt>outline.odt</tt> and/or brings it to the front.''
+ |--------------------------------------------------------
+ |'''9. Choose the place where the reference needs to be'''
+ |Select the "X" described above, which appears in the sentence "I will discuss the relationship between dolphins and seals below (pags '''X''').
+ |---
+ |--------------------------------------------------------
+ |--------------------------------------------------------
+ |'''10. Open the {{Window|Fields}} window'''
+ |Under the {{Menu|Insert}} menu, choose {{Menu|Fields}} then {{Menu|Other...}}
+ | ---
+ |--------------------------------------------------------
+ | ||colspan="2"|''â€”> NeoOffice opens the {{Window|Fields}} dialog box''
+ |--------------------------------------------------------
+ |'''11. Choose the Tab'''
+ |Choose the {{Section|References}} tab if necessary (if you have followed this procedure to the letter, the tab will already be active.)
+ | ---
+ |--------------------------------------------------------
+ |'''12. Prepare the Reference'''
+ |In the left-hand column, choose {{prefName|Insert Reference}} <br />In the {{prefName|Name}} field (at the bottom right of the dialog box), type the exact name that you have given to the reference, here <tt>"relDolphinsSeals" â€” or press Command-v If you copied the name to the clipboard.
+ |---
+ |--------------------------------------------------------
+ |'''13. Format the Reference'''
+ |In the right column {{prefName|Format}}, make sure that {{prefName|Page}} is selected (because we want the page number where the paragraph is found).
+ |---
+ |--------------------------------------------------------
+ |'''14. Insert the Reference'''
+ |Click on the {{Button|Insert}]...<br />then close the {{Window|Fields}} dialog and click on {{Button|Close}}.
+ | Press Return
+ |--------------------------------------------------------
+ | ||colspan="2"|''â€”> NeoOffice closes the {{Window|Fields}} diialog box after inserting the reference in the desired place.<br />For the moment, the text must be (page 1), which is normal because the document has not yet found the definition of this reference.''
+ |--------------------------------------------------------
+ |'''15. Save the Sub-document'''
+ |Save the document â€¦<br />and close it if you do not need to make any other changes.
+ | Command-s (and Command-w)
  |}
-====DeuxiÃ¨me Ã©tape : UTILISATION DE LA RÃ‰FÃ‰RENCE====
+<!--====DeuxiÃ¨me Ã©tape : UTILISATION DE LA RÃ‰FÃ‰RENCE====
 {| cellspacing="8" cellpadding="0" width="100%"
  |Sauver le document (menu <tt>Fichier > Enregistrer</tt>)â€¦<br />et le fermer si aucune autre modification n'est Ã  effectuer.
  | Pomme + s (et Pomme + w)
+ |}-->
+====Step Three: Verify the Reference====
+{| cellspacing="8" cellpadding="0" width="100%"
+ !width="180" align="left"|''Action''
+ !width="*" align="left"  |''Operation / Result''
+ !width="80" align="left" |''Shortcuts''
+ |--------------------------------------------------------
+ |'''16. Verification'''
+ |Bring the master document to the front and update the links by clicking on this icon [[Image:BNavUpdate.png]] in the Navigator; hold down the mouse button and choose "All" from the contextual menu.  Confirm that this is what you want to do in the confirmation box that opens.
+ |---
+ |--------------------------------------------------------
+ | ||colspan="2"|''â€”> If you have followed these instructions to the letter, you will now see, in your document <tt>outline.odt</tt> the correct page number for your chapter on the relationship between dolphins and seals.  <br />  Finally, because we have been speaking about it, can you tell me about this famous relationship between dolphins and seals?...''
  |}
-====TroisiÃ¨me Ã©tape : VÃ‰RIFICATION DE LA RÃ‰FÃ‰RENCE====
+<!--====TroisiÃ¨me Ã©tape : VÃ‰RIFICATION DE LA RÃ‰FÃ‰RENCE====
 {| cellspacing="8" cellpadding="0" width="100%"

Action	Operation/Result	Shortcut
It is assumed that a master document has been created, which contains a sub-document <tt>abstract.odt<tt>and the sub-document <tt>dolphins_and_seals.odt.
1. Edit the sub-documents `dolphins_and_seals.odt`	In the Navigator, in the section "Links," double-click on the sub document `dolphins_and_seals.odt`	---
	â€”> NeoOffice opens the document `dolphins_and_seals.odt` and places it in front.
2. Select the Text of the Reference	In this document, select the title "Relationship between dolphins and seals." (or simply place the cursor at the beginning of this title.)	---
3. Open the Fields Window.	Under the Insert menu, choose Fields then Other....	---
	â€”> NeoOffice opens the Fields* dialog*
4. Choose the Tab	Choose the References tab	---
5. Set the Reference	In the left column, select "Set Reference" In the Name (in the bottom right of the dialog box), give a name to this reference, here `"relDolphinsSeals"`
	Attention ! Make a note of the name that you have given to this reference, because it will not appear later!
	Tip: select the name of the reference using the mouse, the copy it (Command-c). The name will now be on the clipboard; then you can paste it (Command-v)
6. Insert the definition of the reference	Click on the Insert button... ... then close the Fields dialog box by clicking close.
	â€”> NeoOffice closes the Fields* dialog box after creating the (invisible) reference.*
7. Save the Document	Save the document `dolphins_and_seals.odt` (And close it, if you do not have other edits to make in it).	Command-s (then Command-w)

Action	Operation/Result	Short-cut
8. Open the sub-document `outline.odt`	Bring the master document to the front and double-click on the link to the dub-document `outline.odt`in the Navigator.
	â€”> NeoOffice opens the document `outline.odt` and/or brings it to the front.
9. Choose the place where the reference needs to be	Select the "X" described above, which appears in the sentence "I will discuss the relationship between dolphins and seals below (pags X).
10. Open the Fields window	Under the Insert menu, choose Fields then Other...	---
	â€”> NeoOffice opens the Fields* dialog box*
11. Choose the Tab	Choose the References tab if necessary (if you have followed this procedure to the letter, the tab will already be active.)	---
12. Prepare the Reference	In the left-hand column, choose Insert Reference In the Name field (at the bottom right of the dialog box), type the exact name that you have given to the reference, here `"relDolphinsSeals" â€” or press Command-v If you copied the name to the clipboard.`
13. Format the Reference	In the right column Format, make sure that Page is selected (because we want the page number where the paragraph is found).
14. Insert the Reference	Insert}]... then close the Fields dialog and click on Close.	Press Return
	â€”> NeoOffice closes the Fields diialog box after inserting the reference in the desired place. For the moment, the text must be (page 1), which is normal because the document has not yet found the definition of this reference.
15. Save the Sub-document	Save the document â€¦ and close it if you do not need to make any other changes.	Command-s (and Command-w)

Action	Operation / Result	Shortcuts
16. Verification	Bring the master document to the front and update the links by clicking on this icon in the Navigator; hold down the mouse button and choose "All" from the contextual menu. Confirm that this is what you want to do in the confirmation box that opens.
	â€”> If you have followed these instructions to the letter, you will now see, in your document <tt>outline.odt the correct page number for your chapter on the relationship between dolphins and seals. Finally, because we have been speaking about it, can you tell me about this famous relationship between dolphins and seals?...

Cross-references in a Master Document

From NeoWiki

Current revision

Contents

Description of the Problem

More Concretely...

Procedure

Procedure for the Creation of a "Global" Reference

Step One: Defining the Reference

Step Two: Using the Reference

Step Three: Verify the Reference

Views

Personal tools

Navigation

Search

Toolbox