Gretyl's Portal

Heretto Help

Navigational Headings

Navigational headings are a feature in DITA maps that enable you to name sections without using a parent topic. Map titles do not display in a table of contents. You need to insert navigational elements in your DITA map to display map titles in the output. Navigational headings are created with the topichead element.

Note: For more information, see Maps with Map Hierarchy.

Maps Without Navigational Headings

You can create maps with submaps. For example, each chapter of a main map can be organized in its own submap.

Figure 1. Map with Submaps but without Navigational Headings. In this example, the Main Map (outlined in green) contains a hierarchy of submaps (outlined in blue).
example map with no navigational headings
Figure 2. Navigation in Output. Publishing the Main Map generates this navigation in a PDF output. The topic titles (Topic A, Topic B, Topic C) show but the map titles (Getting Started, Interface, Features, Controls) do not. To show map titles, you need to define navigational heading elements in the map.
example PDF output of a map with no navigational headings

Maps with Navigational Headings

Here is an outline of a main map with submaps and a navigational heading for each of the submaps.

  • User Guide (main map)
    • Content Editor (topichead)
      • Content Editor (submap)
        • Interface (topic)
        • Using the Content Editor (topic)
    • Source Editor (topichead)
      • Source Editor (submap)
        • Interface (topic)
        • Using the Source Editor (topic)
Figure 3. Map with Submaps and Navigational Headings. This example shows a map with navigational headings for each submap in the Map Editor and is followed by the source code of the map you would see in Source Editor.
Example of a map with navigational headings
<map id="ditamap-user_guide-7358">
    <title>User Guide</title>

    <topichead>
        <topicmeta>
            <navtitle>Content Editor </navtitle>
        </topicmeta>
        <mapref format="ditamap" href="content_editor.ditamap"/>
    </topichead>

    <topichead>
        <topicmeta>
            <navtitle> Source Editor </navtitle>
        </topicmeta>
        <mapref format="ditamap" href="source_editor.ditamap"/>
    </topichead>

</map>