Contents

# Cross-reference

This is where you insert the references or referenced fields into the current document. References are referenced fields within the same document or within sub-documents of a master document.

The advantage of entering a cross-reference as a field is that you do not have to adjust the references manually every time you change the document. Just update the fields with F9 and the references in the document are updated too.

To access this command...

#### From the menu bar:

Choose Insert - Field - More Fields - Cross-references tab

Choose Insert - Cross-reference

#### From the tabbed interface:

Choose Insert - Cross-reference.

Choose References - Cross-reference.

#### From toolbars:

Insert Cross-reference

#### From the keyboard:

Command Ctrl + F2

Inserting Cross-References

## Type

Lists the available field types. To add a field to your document, click a field type, click a field in the Selection list, and then click Insert. The following fields are available:

Type | Meaning
--- | ---
Set Reference | Set target for a referenced field. Under Name, enter a name for the reference. When inserting the reference, the name will then appear as an identification in the list box Selection. In an HTML document, reference fields entered this way will be ignored. For the target in HTML documents, you have to insert a bookmark.
Insert Reference | Inserting a reference to another position in the document. The corresponding text position has to be defined with "Set Reference" first. Otherwise, inserting a reference by choosing a field name under Selection is not possible. In master documents, you can also reference from one sub-document to another. Note that the reference name will not appear in the selection field and has to be entered "by hand". In an HTML document, reference fields entered this way will be ignored. For referenced fields in HTML documents, you have to insert a hyperlink.
Headings | The Selection box shows a list of all headings in the order of their appearance in the document.
Numbered Paragraphs | The Selection box shows a list of all ordered paragraphs in the order of their appearance in the document. The list includes: paragraphs with a paragraph style assigned a numbering scheme in the Tools > Heading Numbering dialog ordered list paragraphs, formatted with the Formatting toolbar or Bullets and Numbering dialog paragraphs formatted with a numbered list style paragraphs formatted with a paragraph style with a numbered list style applied in the Outline & List tab.
Bookmarks | After inserting a bookmark in the document with Insert - Bookmark, the bookmarks entry on the References tab becomes usable. Bookmarks are used to mark certain text passages in a document. In a text document, you can use the bookmarks, for example, to jump from one passage in the document to another. In an HTML document, these bookmarks become anchors <A name>, which determine the target of hyperlinks for example.
Footnotes | If your documents contains a footnote, you can select the Footnotes entry. A reference to a footnote returns the footnote number.
(Inserted objects with captions) | You can set references to objects that have captions applied. For example, insert a picture, right-click the picture, choose Caption. Now the object shows up as a numbered "Illustration" in the list.

References are fields. To remove a reference, delete the field. If you set a longer text as a reference and you do not want to reenter it after deleting the reference, select the text and copy it to the clipboard. You can then reinsert it as "unformatted text" at the same position using the command Edit - Paste special. The text remains intact while the reference is deleted.

## Selection

Lists the available fields for the field type selected in the Type list. To insert a field, click the field, select a format in the "Refer using" list, and then click Insert.

To quickly insert a field from the list, hold down Command Ctrl and double-click the field.

## Refer using

Select the format that you want to use for the selected reference field. The following formats are available:

Format | Meaning
--- | ---
Page number (unstyled) | Inserts the number of the page containing the reference target.
Chapter | Inserts the heading number or list number of the reference target.
Referenced text | Inserts the complete reference target text. For footnotes the footnote number is inserted. For captions the complete caption (category, number and text) is inserted.
“Above”/“Below” | Inserts "above" or "below", depending on the location of the reference target relative to the position of the reference field.
Page number (styled) | Inserts the number of the page containing the reference target using the format specified in the page style.
Number | Inserts the number of the heading or numbered paragraph, including superior levels depending on the context. See note below this table for more information.
Number (no context) | Inserts only the number of the heading or numbered paragraph.
Number (full context) | Inserts the number of the heading or numbered paragraph, including all superior levels.
Category and Number | Inserts the caption category and caption number (or number range variable name and value). Any text between the category and number (or variable name and value) is also inserted. This option is available for all number range variables, including caption numbers.
Caption Text | Inserts all text that follows the caption category and caption number until end of paragraph. This option is available for all number range variables, including caption numbers.
Number | Inserts the caption number (or number range value). This option is available for all number range variables, including caption numbers.

For “Chapter”, “Number”, “Number (no context)”, and “Number(full context)” formats, the number of sublevels shown for the selected format depends on the Show sublevels setting for the relevant outline levels in Tools - Heading Numbering.

## Name

Type the name of the user-defined field that you want to create. To set a target, click "Set Reference" in the Type list, type a name in this box, and then click Insert. To reference the new target, click the target name in the Selection list.

In a master document, targets that are in different sub-documents are not displayed in the Selection list. If you want to insert a reference to the target, you must type the path and the name in the Name box.

## Value

Enter the contents that you want to add to a user-defined field.

If you select text in the document, and then insert a reference, the selected text becomes the contents of the field that you insert.

Please support us!