24.8.5 Specifying alternate titles for a DITA topic

To include an alternate title for a topic, you can use either of the following:

Dedicated paragraph format

PI marker

The text of an alternate title, whether provided via paragraph format or marker, appears as follows: 

Navigation title:

navtitle attribute in the map <topicref>

Search title:

<searchtitle> element in the <topicmeta> of the map’s <topicref>

In addition, both appear as elements in the topic itself, in a <titlealts> block immediately following the <title> element. DITA2Go provides the <titlealts> wrapper for alternate titles.

Dedicated paragraph format

To use a dedicated paragraph format for an alternate title, place a paragraph in that format after the main title paragraph, and map the format to the alternate-title element. For example:

[DITAParaTags]
; Frame para format (wildcards OK) = DITA element
NavHead = navtitle
Search = searchtitle

See §24.4.3 Mapping paragraph formats to DITA block elements.

PI marker

To use a PI marker for an alternate title, insert a DITANavTitle PI marker, a DITASearchTitle PI marker, or both, in the <title> paragraph. Make the content of the marker the text of the alternate title, which becomes the content of the navtitle attribute or <searchtitle> element.

Previous Topic:  24.8.4 Adjusting DITA topic IDs generated from file names

Next Topic:  24.8.6 Omitting a DITA topic from the TOC

Parent Topic:  24.8 Configuring DITA topics

Sibling Topics:

24.8.1 Designating starting points for DITA topics

24.8.2 Specifying the DITA topic type

24.8.3 Specifying the ID for a DITA topic

24.8.4 Adjusting DITA topic IDs generated from file names

24.8.6 Omitting a DITA topic from the TOC

Table of ContentsIndex