Group topics in DITA maps

Referring to DITA maps from a bookmap or from another DITA map provides a great way for grouping topics. You can refer to the DITA map in the bookmap, or in a parent ditamap, whenever you want to include the collection of topics in the bookmap.

Tip:
You can still use a DITA map to group topics when slight variations in the map are required (such as a topic describing how to use a feature applies to variant A of the product but not to variant B of the product.) Apply conditions to the topic references in the DITA map (such as “gram-negative”) and when the map is published (for example, for “gram-positive”), topics can be filtered out by condition.

Topics, taken alone, are generally just part of larger units of information. To organize your topics meaningfully, you can:

  • arrange topics into chapters and parts in the bookmap,
  • group topics in DITA maps, and
  • nest child topics under parent topics (sometimes called super topics, super tasks, or chapter maps).
  • nest topics under topic headings

When to use DITA Bookmaps instead of a regular ditamap to group content

Use DITA bookmaps when you need to support front and back matter, or support division into chapters or parts. Use regular DITA maps for grouping a cluster of topics. Click here to learn more about nesting topics in DITA.

Your next steps in using DITA maps more effectively

Learn more about DITA bookmaps. Or, get help right now from the DITA gurus at Method M.