25.1.1.2 Choosing whether a ditamap references maps or topics

Ideally, a chapter map references topics, and a book map references chapter maps. However, not all DITA tools allow nested maps. Therefore the default DITA2Go option is to have the book map reference topics directly rather than reference the chapter maps.

To include in the book .ditamap references to chapter maps instead of direct references to each topic:

[DITAOptions]
; MapBookTopics = Yes (default, include <topicref> for each topic in
;  book .ditamap), or No reference the chapter maps instead)
MapBookTopics = No

Referencing chapter maps is better practice, if your downstream tools support this approach.

Previous Topic:  25.1.1.1 Choosing whether to overwrite ditamaps

Next Topic:  25.1.1.3 Specifying the base file name 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.3 Specifying the base file name for a ditamap

25.1.1.4 Specifying a title for a chapter or book ditamap

25.1.1.5 Specifying a navigation title for a ditamap

25.1.1.6 Specifying the ID for a ditamap