A cross-reference refers the reader from one place in a publication's text to another place, such as a chapter, a note or a figure. For example, "For more information, see Spring-Flowering Shrubs on page 32."
Cross-references are inserted into document text and managed using the Cross-References panel.
Each cross-reference in document text is a field, which allows its value to be easily updated as your publication's content changes.
Inserting cross-references
When you insert a cross-reference, the Insert Cross-Reference dialog is shown.
On the dialog:
Set (or 'link to') a target, which can be an existing anchor, paragraph or index mark.
Set the text to be displayed in your document, including subfields that describe the target or its position.
Select a character style to apply to the cross-reference's text, overriding the formatting at its position in document text.
Topics linked below explain how to set a cross-reference's target, text and formatting.
Editing existing cross-references
The options shown when editing cross-references differ depending on how many are selected on the Cross-References panel.
When one cross-reference is selected, you can edit any of its settings, i.e. the full range of target, text and formatting options that were available when inserting the cross-reference.
When multiple cross-references are selected, you can edit their text and formatting but not their targets. This allows you to easily ensure multiple cross-references have the same phrasing and appearance.
To insert a cross-reference:
Create an insertion point in text.
On the Cross-References panel, select Insert Cross-Reference.
On the dialog that appears:
Select the required target's type from the Link to pop-up menu.
(Optional) Use the filter options to limit what is shown in the targets list.
Select the required target from the targets list.
Set the Text to display in document text.
(Optional) Select a character style and the parts of the cross-reference's text to apply it to, from the Style override and For pop-up menus, respectively
Select OK.
Options for setting a cross-reference's text and formatting are explained in topics linked below.
To edit an existing cross-reference:
On the Cross-References panel:
Select one or more cross-references.
Select Edit Cross-Reference.
On the dialog that appears, set the target, text and formatting options as required.
Select OK.
To convert cross-references to regular text:
In document text, long press a cross-reference's text, release, and then select Expand.
The cross-reference is removed from the Cross-References panel. Its value remains in the document as regular text and can be edited directly.
A cross-reference is automatically converted to regular text when deleted via the Cross-References panel.
To navigate to a cross-reference's target:
On the Cross-References panel:
Select the cross-reference.
Select Go to Target.
An insertion point is created at the target's position.
To navigate to a cross-reference's document text:
If the cross-reference's document text is not shown in the document view, on the Cross-References panel:
Select the cross-reference.
Select Go to Cross-Reference.
The document view jumps to the cross-reference's document text, which is automatically selected.
If the cross-reference's document text is shown in the document view, double-tap it to select it.
To remove a cross-reference:
Navigate to the cross-reference's document text and do one of the following:
On the Quick Menu, select Cut.
On the on-screen or hardware keyboard, press the .
Long press the cross-reference's document text, release, and then select Cut.
The cross-reference is removed from the Cross-References panel and the document text.
To remove cross-references:
On the Cross-References panel:
Select the unwanted cross-references. (-tap to select more than one.)
Select Remove Cross-References.
Select Yes to convert the cross-reference's field to regular text.
(Optional) To remove the resulting text from your document, do one of the following:
If you selected one cross-reference, or if you selected multiple cross-references and their fields were in the same text object (including a sequence of linked text frames), the resulting text is automatically selected. Press the to remove it.
If you selected multiple cross-references and their fields were in different text objects (excluding a sequence of linked text frames), you will need to inspect your document text and manually remove any unwanted text.
An individual cross-reference can also be completely removed by doing one of the following:
Double-tap its field in document text and then select Cut from the Quick Menu.
Long press its field in document text, release, and then select Cut.