Topics are the building blocks of modular documents, and organising topics by semantic information types is one of the architectural features of DITA.
DITA map files are used for defining the topics of a publication, specifying the topic sequence, and controlling linking between topics.
Any topics referenced anywhere in the ditamap will be processed into the output publication.
In DITA, the sequence and hierarchy of the topics to be published are defined in the ditamap through nested topicref elements.
Relationship tables are used to store linking relationships between topics in a collection in the ditamap, rather than in individual topics. Linking relationships are defined in a table-like structure, with rows in the table determining which topics are linked to which.
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.
Properties in ditamaps sometimes cascade from parent elements to child elements. Some values in ditamaps also override the equivalent values in referenced topics.
The technique of using embedded, or nested, ditamaps can make it easier to manage documents by separating complex collections of topics into a number of smaller, simpler collections.
Bookmaps are a specialisation of the base DITA map information type. Like ditamaps, bookmaps are containers for structure and context metadata, and do not contain any content. Bookmaps are used to describe page layout publishing outputs such as books, articles, manuals and research papers. They contain information structures that are specific to linear publications, such as tables of figures, title pages, chapters, sections and parts.
Cross-references are a means of binding individual topics into a coherent and navigable document.
Moving from style-based authoring to a structured authoring methodology such as DITA requires a radically different approach to writing.
Hic sunt dracones (Here be dragons!) Phrase on the 16th Century Lennox Globe map