6.4.3 Overriding element paths for default formats

DITA maps and projects can be set up many different ways. The default output formats (and their mappings from elements) included in the DITA2Go distribution reflect only one possible configuration. You can find and inspect the default element paths in distribution file %omsyshome%\d2g\configs\system\d2g_config.ini.

For example, for glossary content for Help systems, DITA2Go covers the bookmap case. In d2g_config.ini:

[BlockFormatMaps]
title/$topic/glossarylist/booklists/backmatter/$map/1=GlossaryTitle
glossterm/*=Heading1
glossdef/*=Abstract

And in d2help_config, Heading1 is one level under GlossaryTitle:

[HelpContentsLevels]
GlossaryTitle=2
Heading1*=3

so the glossary terms nest under the glossary title.

However, if you have the glossary nested under a top-level topic, the glossary terms are at the same level. The fix is to override the default mapping and lower the glossary terns one level:

[BlockFormatMaps]
glossterm/*=Heading2

That way the glossary terms nest under the title topic.

Previous Topic:  6.4.2 Mapping block and inline element paths to formats

Next Topic:  6.4.4 Mapping the same element to different formats

Parent Topic:  6.4 Mapping element paths to output formats

Sibling Topics:

6.4.1 Understanding element paths

6.4.2 Mapping block and inline element paths to formats

6.4.4 Mapping the same element to different formats

6.4.5 Filtering out elements via format mapping