DITA Cross-References

Understand how to work with DITA cross-references in Adobe FrameMaker.

You can provide your readers with links to elements contained in the same topic or to elements in other topics. In FrameMaker, you can create links using DITA cross-references. A DITA cross-reference is based on the DITA ID attribute assigned to the target element. If the position of an element in the target topic changes, the link remains intact as long as the ID remains intact.

You can use direct referencing to point directly to the DITA topic (.xml file) containing the target topics or elements. Alternatively, you can use indirect referencing to point to keys defined in keyspaces.

You can create cross-references to almost any element in the DITA element catalog. You create cross-references to a DITA <topic> to make an entire topic reusable. You can also create a cross-reference to a section, complete lists or list items, table cells, paragraphs, or even a single word or number marked up with elements like <keyword> or <ph>. The only requirement to create a cross-reference is that the element must have an ID attribute.