25.1.1.4 Specifying a title for a chapter or book ditamap

Arbitrary chapter map title

To specify a title for a chapter map, include the following setting in a chapter-specific configuration file named for the DITA file (see §42.1.1 Providing configuration files for individual ditamaps):

[DITAOptions]
; MapTitle = content of <title> element for chapter map
MapTitle = This is the title of the current chapter map

When you provide a value for MapTitle, DITA2Go sets a <title> element at the start of the chapter map (effectively at map level 0); the value assigned to MapTitle becomes the content of the element.

Alternatively, you can insert a DITAMapTitle PI marker in the chapter file. The content of the marker becomes the content of the <title> element for the map generated from that file, overriding any value specified for MapTitle.

First topic title as chapter map title

To use the title of the first topic as the chapter map title:

[DITAOptions]
; UseAltMapTitle = No (default) or Yes (if no title specified for map,
; use the navtitle of the first topic in the file as the map title)
UseAltMapTitle = Yes

When UseAltMapTitle=Yes, the alternate title overrides the value of MapTitle.

Book map title

To specify a title for the book map that is generated from a book file, in your project configuration file:

[DITAOptions]
; BookMapTitle = content of <title> element for book map.
BookMapTitle = This is the title of the book map

You cannot use a PI marker to override the title for a book map file.

Previous Topic:  25.1.1.3 Specifying the base file name for a ditamap

Next Topic:  25.1.1.5 Specifying a navigation title for a ditamap

Parent Topic:  25.1.1 Specifying options for ditamaps

Sibling Topics:

25.1.1.1 Choosing whether to overwrite ditamaps

25.1.1.2 Choosing whether a ditamap references maps or topics

25.1.1.3 Specifying the base file name for a ditamap

25.1.1.5 Specifying a navigation title for a ditamap