Cross-References and Links
In your topics, you can add cross-references or links to:
-
Web sites or documents that are stored on the web
-
Files that are stored locally, such as PDFs (for HTML outputs)
You can also use images as links, and use links to embed GoogleDoc and OneDrive documents.
We recommend that you only use cross-references where necessary. This is because with cross-references, you create dependencies. If one topic links to another, both of those topics need to be included in a publication, otherwise the link will not work. As a result, the topics are dependent on each other and this makes it more difficult to reuse them independently.
If you already have a cross-reference and you need to change it, see Edit a Cross-Reference Link.
You can also make images work as links. There is however no selection dialog to insert that type of link. You do it by adding the link target as an attribute on the image itself:
-
Select the
mediaobject
orinlinemediaobject
element. -
Add an
xlink:href
attribute. -
Add the target value using the following syntax:
urn:resource:component:31214
.The first part is always the same, and the last part (the numbers) is the id of the target topic.
Tip
You can get the id of the target topic by opening the Structure View for that topic, where you find it at the top of the metadata.
Another way to get the entire link value is to simply make a regular ("dummy") cross-reference, and then copy the value from there and then delete the dummy cross-reference.