14.3.1 Deciding whether to produce a table of contents

By default, DITA2Go produces a table of contents from a DITA bookmap or a ditamap file, following DITA rules. For HTML output, DITA2Go creates a separate file for the TOC. To keep the TOC with any material that precedes it in output, see §27.2.3 Providing a page break between title and TOC. For RTF output, the TOC does not become a separate file.

To prevent DITA2Go from generating a table of contents:

[Contents]
; GenerateTOC = Yes (default) or No (omit TOC)
GenerateTOC = No

When GenerateTOC=Yes, DITA2Go creates a table of contents from the topic titles in your DITA source. However, if you are producing a Help system such as HTML Help or Oracle Help for Java, a table of contents is produced automatically.by the Help system tool; so for Help systems you do not really need another, unless you intend to use it as the default start page of your output.

When GenerateTOC=No, DITA2Go does not create a table of contents.

Previous Topic:  14.3 Generating a table of contents

Next Topic:  14.3.2 Specifying a file name and title for the TOC

Parent Topic:  14.3 Generating a table of contents

Sibling Topics:

14.3.2 Specifying a file name and title for the TOC

14.3.3 Deciding what to include in the TOC

14.3.4 Specifying formats for TOC entries and references

14.3.5 Including navigation titles from maps in the TOC