#### 25.1.5 Providing navigation aids in ditamaps

To add navigation elements to the map entry for a topic, insert PI markers in the <title> paragraph of the topic. Table 25-1 shows the content and placement of the navigation element for each PI marker type.

Table 25-1 DITA map navigation elements from PI markers

PI marker type | Marker content | Map element | Map placement
DITAAnchor | id attribute |
    <anchor>
| After the <topicref> of the topic
DITANavref | mapref attribute |
    <navref>
| After the <topicref> of the topic
DITAMapref | href attribute |
    <topicref>
| After the <topicref> of the topic
DITALinkText | text for the link |
    <linktext>
| In the map <topicmeta>

The content of a DITAMapref PI marker should be a map file name. DITA2Go sets the format attribute of the resulting <topicref> element to "ditamap".

Previous Topic: 25.1.4.5 Specifying a collection-type attribute for each topic type

Next Topic: 25.2 Overriding map settings with PI markers

Parent Topic: 25.1 Configuring ditamaps

Sibling Topics:

25.1.1 Specifying options for ditamaps

25.1.2 Specifying topic levels in ditamaps

25.1.3 Specifying roles for topics in ditamaps

25.1.4 Adding relationship tables to ditamaps