25.1.2 Specifying topic levels in ditamaps

To specify map levels for topics, assign a level number to each format that you map to a <title> element at the topic level in [DITAParaTags]; see §24.4.3 Mapping paragraph formats to DITA block elements. For example:

[DITAMapLevels]
; para format = level of topics it starts in ditamap, default 1.
Heading1 = 1
Heading2 = 2

Each instance of a paragraph format assigned a level number generates a <topicref> that nests the lower <topicref> elements. For paragraph formats that are not listed here, but that are mapped to <title> elements at the topic level in [DITAParaTags], DITA2Go uses any level assignments you have provided for those formats in [HelpContentsLevels]. See §16.4.3 Setting contents levels for HTML-based Help.

If you direct DITA2Go to nest topics, DITA2Go adjusts map levels as follows:

Any adjustments to map levels also affect the chapter ditamap.

See also:

§24.5.12 Specifying DITA element levels

Previous Topic:  25.1.1.5 Specifying a navigation title for a ditamap

Next Topic:  25.1.3 Specifying roles for topics in ditamaps

Parent Topic:  25.1 Configuring ditamaps

Sibling Topics:

25.1.1 Specifying options for ditamaps

25.1.3 Specifying roles for topics in ditamaps

25.1.4 Adding relationship tables to ditamaps

25.1.5 Providing navigation aids in ditamaps