Linking relationships

DITA encourages the linking relationships to be stored outside the topic content. Links can be generated from topic hierarchies, relationship tables, and related-links section links.

One of the most powerful features of DITA is the automatic generation of cross-reference links in the output. This feature allows greater content re-use, as it removes linking context from topics and moves it to the map.

Cross-reference links at the bottom of output topics are generated by hierarchical relationships defined in the ditamap, non-hierarchical relationships defined in the reltable section of the ditamap, and links defined in the related-topic section of the individual topic.

Of course, how links are generated will ultimately be up to the publishing engine you use.

The collection-type and linking attributes (of the topicref and relcell elements) allow you to fine-tune the way in which links are generated.