DITA maps and their usage
DITA maps serve a variety of roles, both setting up navigation hierarchies and creating relationships between topics and resoruces. These relationships can be both explicit based on relationship tables and attributes within the map, and implicit based on how topic references are nested within the map.
TODO: Current topics with applicable content
TODO: verify that content in the referenced topics below is consistent with or compliments the new topics created for this section.
| Topic | Applicable content |
|---|---|
| 3.4.5.1 Example: DITA map that references a subordinate map | Resolution of a submap. |
| 3.4.5.2 Example: DITA map with a simple relationship table | How links are generated from a relationship table; how processors might represent a relationship table. |
3.4.5.3 Example: How the @collection-type and @linking
determine links |
Effect of @collection-type and @linking attributes on
generated links. |
| 6.1 Navigation | Container topic; incorporate into new "DITA maps and their usage" cluster. |
| 6.1.1 Table of contents | All content is applicable and needs to be incorporated into the new "DITA maps and their usage" cluster – Closest thing we currently have to a topic about how maps create hierarchies. |
9.3.1.1 <map> |
Relationships between topics created by map hierarchy or @collection-type
attribute; role of titles, especially in submaps. |
9.3.1.2 <topicref> |
Role of <topicref> nesting in creating containment hierarchies and
parent-child relationships. |
9.3.1.6 <reltable> |
Relationship table titles – Processing expectations for relationship tables (not rendered,
used to generate links) – Within a map tree, the effective relationship table is the union of all relationship tables in the map.– How a DITA-aware tool might represent the <reltable> element graphically. |
9.3.1.10 <relcolspec> |
How labels for related links from a relationship table are generated. |
9.3.2.3 <mapref> |
The hierarchy of the referenced map is merged into the container map at the position of the reference, and the relationship tables of the child map are added to the parent map. |
9.3.2.4 <topicgroup> |
How processors handle navigation titles within <topicgroup>
elements. |
9.8.13.10 The @format attribute |
How processors determine the value of the @format attribute when it is not
explicitly set. |