Table of content configuration

It is possible to configure if and how the table of content is shown in the html output for each article.

By default a table of content is shown for an article in if this article has at least 3 chapters or titles in the article.

General configuration of the table of content

Several command-line or configuration file properties allow to configure the table of content for each article:

• hasTOC: specifies if the table of content must be presented. If set to false, no table of content will be presented on articles, regardless of their number of titles
• tocThreshold: specifies the threshold of the number of titles for articles on html. By default an article must have at least 3 titles to have a table of content

For example:

      java -jar docGenerator.jar -input=wiki/input -output=wiki/output -hasTOC=false

will not present any table of content for any article.

      java -jar docGenerator.jar -input=wiki/input -output=wiki/output -tocThreshold=5

will only present a table of content for articles which have at least 5 titles.

Configuring the table of content for one article

The toc attribute for an article specifies that this article will not have a table of content regardless of the general configuration (it can only have the false value if present).

For example:

   <article desc="an article without a toc" toc="false">
   ...
   </article>