The publication map and publication metadata domains provide a rich set of topic references and metadata elements for use in maps that can represent almost any existing or possible publication.
The publication map and publication metadata domains are used to create maps that represent publications of any sort. The markup is designed to enable maximum structural flexibility rather than imposing specific organizational rules. The markup design reflects the following general patterns:
- Topicrefs that represent specific components of publications, e.g.,
<preface>, have a corresponding mapref version for linking to a DITA map for that publication component (e.g.,
<preface-mapref>). While the non-mapref-specific topicref can, of course, be used to refer to submaps, the -mapref versions provide convenient markup for creating submap references and make the map author's intent clear.
- For the publication as a whole and for each submap that represents a complete publication component, there is always a root topicref element that roots the navigation tree for the publication or publication component content. This provides a consistent pattern for root maps and submaps and makes it clear which part of the map represents the content, as opposed to metadata or relationship tables. It also means that for each *-mapref element there is a corresponding topicref for use in the referenced map, so that the correspondence between map references and the referenced content is clearer to map authors.
- The domain imposes few constraints on how different kinds of topicrefs can be combined, reflecting the fact that some publications may need to do what might seem like nonsensical or non-standard things in terms of organization.
- Key definitions may be organized into a separate
<keydefs>element or organized into a separate submap. Key definitions can also be grouped within
The publication map and publication metadata domains can be used with other map domains, such as the Learning and Training map domain or with generic maps. The pubmap map type provides a simple integration of the publication map and publication metadata domains useful for representing generic, unconstrained, publications.