You are here: Features > Navigation Links > Cross-References > Creating Context-Sensitive Cross-References

Creating Context-Sensitive Cross-References

For print-based output you can create context-sensitive cross-references, which automatically change the text in the link based on the relationship of the cross-reference and the target location.

example

Let's say that you have a cross-reference that is designed to display the text "See Figure 2.1." If the link and the target fall on the same page, the cross-reference is updated to display the text, "See Figure 2.1 above" or "See Figure 2.1 below." If the link and the target are on adjacent pages, the cross-reference is updated to display the text, "See Figure 2.1 on the previous page" or "See Figure 2.1 on the next page." If the document is double-sided with the link on the left page and the target on the right page, the cross-reference is updated to display the text, "See Figure 2.1 on the facing page."

Using context-sensitive cross-references is simply a matter of using the correct command. In other words, instead of using the simple {page} command, you can use the {pageref} command.

example

Let's say you use the plain {page} command. Perhaps the complete format that you create for a cross-reference style is this:

See "{paratext}" on page {page}.

When you generate the output, this cross-reference will be converted to something like the following, regardless of where the link falls in relation to its destination:

See "My Information" on page 42.

However, let's say that you use a slightly different format, something like this:

See "{paratext}" {pageref}.

When you generate the output, what you see in place of {pageref} depends on the relative closeness of the link and the destination. It might be translated as any of the following:

See "My Information" below.

See "My Information" above.

See "My Information" on previous page.

See "My Information" on page 42.

How to create context-sensitive cross-references

Go through the process of inserting or editing a cross-reference. See Inserting Cross-References into Topics and Editing Cross-References.
In the Insert Cross-Reference dialog, select either New or Edit, depending on whether you want to create a new cross-reference style or edit an existing one.
Provide a format in the Enter format field. This format can be a combination of text and automated commands.

When creating this format, make sure you include the {pageref} command in it. You can find the command by selecting either Show All or Show Page Commands. When you find the {pageref} command in the list, double-click it to add it to the format. Here is an example of a format that contains a context-sensitive cross-reference command: See "{paratext}" {pageref}.
Click OK.

Note: You also have control over the text used in context-sensitive cross-references (e.g., instead of the text displaying "on next page," it can be customized to display "on following page"). You can customize this text through the use of a language skin. See Editing Text for Context-Sensitive Cross-References.