Displaying topic titles in the DITA Map view

The DITA Map view lists the topics that are included in a map.

The topic title displayed in the map may come from different sources, such as the <title> element or <navtitle> element or attribute, depending on how the topic is defined in the map:
  • If the topic is a reference to an existing topic file, the title displayed in the map is the value of the <title> element set in the topic file. This will be the case for most topics.

    For example, consider the following chapter in a map:

    <bookmap id="lar1367336063736" xml:lang="eng">
    	<title>Sample Bookmap</title>
    	<chapter href="topicA.xml"/>
    </bookmap>
    The topicA.xml file has the following content:
    <concept id="topicA" xml:lang="eng">
    	<title>Topic A title, taken from title element</title>  
       <conbody>
          ...
       </conbody>
    </concept>
    The title of this chapter will be "Topic A title, taken from title element" in the DITA Map view, as shown below:
    Topic title A
  • If the topic is not an href, that is, it does not reference an existing topic file, then the title is taken from the navtitle attribute set directly on the topic, if available.

    For example, consider the following map:

    <bookmap id="lar1367336063736" xml:lang="eng">
    	<title>Sample Bookmap</title>
    	<chapter/>
    	<chapter href="lar1367336223394.xml" keys="lar1367336223394"/>
    	<chapter navtitle="Topic title, taken from navtitle attribute">
    		<topicref href="jan1237671609803.xml" keys="jan1237671609803"/>
    		<topicref href="jan1237595719998.xml" keys="jan1237595719998"/>
    	</chapter>
    </bookmap>
    The chapter highlighted in bold does not refer to an existing topic file; instead, it is used as a container chapter for a set of topics. The title of this chapter will be "Topic title, taken from navtitle attribute", as shown below:
    Topic Title from Navtitle attribute
  • If the topic is not an href and the navtitle attribute is not set directly on the topic, then the title is taken from the <navtitle> element if set for that topic.

    For example, consider the following map:

    <bookmap id="lar1367336063736" xml:lang="eng">
       <title>Sample Bookmap</title>
       <chapter/>
       <chapter href="lar1367336223394.xml" keys="lar1367336223394"/>
       <chapter navtitle="Topic title, taken from navtitle attribute"/>
       <chapter>
          <topicmeta>
             <navtitle>Topic title, taken from navtitle element</navtitle>
          </topicmeta>
    	  <topicref href="jan1237671609803.xml" keys="jan1237671609803"/>
    	  <topicref href="jan1237595719998.xml" keys="jan1237595719998"/>
       </chapter>
    </bookmap>
    The title of the chapter highlighted in bold will be "Topic title, taken from navtitle element", as shown below. Note that, to show that the title was not set directly on the chapter element but rather was pulled from another element, the title is displayed in italics and starts with a number sign (#):
    Topic Title, taken from navtitle element
Some notes:
  • For all maps other than bookmaps, the titles for topics that are not hrefs are only displayed when the Show Elements option is selected.
  • The display of navtitle attributes and elements in the output depend on your transformation scenarios. This section only covers how they are displayed.