Skip to main content

Add Cross-Reference Within the Topic

To add a cross-reference to an element that is elsewhere in the same topic:

  1. Select the topic or component in the Content Manager to open it in the Editor.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternatively, you can Create a Topic and edit that.

  2. Position the cursor where the link is to be inserted.

    Tip

    Alternatively, highlight the text that you want to use as link label.

  3. Select the Insert tab in the Toolbar.

    Insert tab on the main editor.

  4. Select Link and choose Cross-reference. Insert_Link.png

    Cross-reference_LinkMenu_small.png

    Tip

    Or use the keyboard shortcut Alt + R (Windows) or Option ⌥ + R (Mac) to add the cross-reference.

  5. Enter a text as Link Label. Leave it blank if you want the link text to be the same as the topic title, see Auto-Text for Cross-References.

    Linklabel_small.png

    Note

    If you are linking to a procedure step or a list number, leave the Link Label field empty. Make sure that the auto box is checked, as this is needed for the link to show the list item or step number.

    Also note that when you add the cross-reference, it will appear as a code reference. When you publish, this will be replaced by the step number. You can preview it before publishing, see Preview a Topic.

    link-to-step-step-added.jpg

  6. Select the Internal target tab to select an element inside your topic that currently have an xml:id.

    Any elements that do not have an ID are not listed. You can generate an ID manually, see IDs for Cross-References).

    Note

    To link to a subsection heading in a topic, choose the section element of the subsection. Do not choose the title element as the link should be to the section as a whole, not just the title.

    crossreferenceinternal.png

  7. Select Save. Save icon.