14.3.2 Deciding what to include in the TOC

By default, DITA2Go includes all topicref titles in the TOC, except the topicref for the TOC itself.

To also include TOC entries for nested topics:

[Contents]
; UseNestedTopicsInTOC = No (default) or Yes (add them
; as though they were specified in map topicrefs)
UseNestedTopicsInTOC = Yes

To also include shortdesc content in TOCs generated from maps:

[Contents]
; UseTOCDescriptions = No (default, omit shortdesc from TOC) or Yes.
UseTOCDescriptions = Yes

When UseTOCDescriptions=Yes, DITA2Go includes in the generated TOC all text material from the map. For HTML output, the shortdesc content appears in a mouseover. For RTF output, it seriously clutters the TOC, especially for large documents.

The values of UseNestedTopicsInTOC and UseTOCDescriptions apply to all TOCs produced in your current project.

See also:

§6.12.1 Providing default output formats for map content

§6.13 Deciding where to display title and shortdesc

Previous Topic:  14.3.1 Specifying a file name and title for the TOC

Next Topic:  14.3.3 Specifying formats for TOC title, entries, and references

Parent Topic:  14.3 Generating a table of contents

Sibling Topics:

14.3.1 Specifying a file name and title for the TOC

14.3.3 Specifying formats for TOC title, entries, and references

14.3.4 Including navigation titles from maps in the TOC

Table of ContentsIndex