Creating Named Destinations

A named destination lets you point to a specific place in a PDF. In the Insert Hyperlink dialog, you can create links to named destinations when using the "External File" option.

How to Insert a Named Destination Manually

1. Open the document where you want insert a named destination (i.e., hyperlinks in another file will point to the PDF holding this destination).
2. Click in the document where you want to insert a named destination (e.g., in front of a subheading or a specific paragraph).

3. Select Insert > Named Destination.

   The Named Destination dialog opens.

4. In the Name field, type a name for destination (do not use spaces).
5. Click OK. An icon is displayed at the appropriate location in the document (as long as your markers are turned on).
6. Click to save your work.

How to Create a Link to a Named Destination

1. Open the document where you want the link to exist.
2. Highlight the text that you want to use as the link (or "hotspot").

3. Do one of the following, depending on the part of the user interface you are using:

   • Ribbon Select Insert > Hyperlink.
   • Local Toolbar In the local toolbar of the XML Editor click .
   • Keyboard Shortcut Press CTRL+K on your keyboard.
   • Right-Click In the XML Editor, right-click and select Hyperlink.
4. From the Link to drop-down field select External File.
5. Enter the path to the PDF file in the field next to the External File button.
6. After selecting the PDF, click .
7. In the dialog that opens, select the named destination and click OK.
8. (Optional) The Link text field displays the text that you highlighted in the topic, which will be used as the hyperlink. Leave the text as it is, unless you decide you would like to change it. If you want to change the link text, type the new text in the field. It will replace the previously selected text in the topic.

9. (Optional) In the Screen Tip field you can type a phrase that will appear when the end user hovers over the hyperlink in the output.

   When you enter a screen tip, it is added as a <title> tag in the markup. In addition, an <alt> (alternate text) tag is added with the same text. This is useful when it comes to accessibility.

10. (Optional) Next to the Style Class field click the Select button. This opens the Select Class dialog, which lets you apply one of the defined hyperlink styles from your stylesheet to the link. You can change the appearance of the link in the Stylesheet Editor. After you select a style class in the dialog, click OK. The Style Class field displays the selected style. (If you do not specify a style class, Contributor uses the parent "a" style.)

11. (Optional) In the Target Frame field, click the drop-down arrow to select the way the linked destination will open (e.g., in another window, in a popup).

    • Page Default The destination file opens in the same window as the output window.
    • Parent Frame The destination file opens in the parent frame of the current topic while hiding that topic.
    • New Window The destination file opens in a new browser window.
    • Same Frame The destination file opens in the same window frame as the current topic.
    • Top Frame The destination file opens in the same output window, removing all other framesets. You might use this option, for example, if the destination topic has its own frameset.
    • Popup Window The destination file opens in a popup box on top of the current topic.
12. Click OK. The hyperlink is added to the topic.
13. Click to save your work.

What’s Noteworthy?