Specifying Table of Contents Settings
ePublisher allows you to specify whether you want to generate a table of contents, the file name you want to specify for your table of contents file, and how you want your table of contents to display in your generated output.
ePublisher provides table of contents settings to help you address how you want your table of contents to display. By default, ePublisher uses the table of contents levels specified in the project or in the Stationery file to create a table of contents for your help system based on the heading levels in your source documents. However, if you have source documents where writers skipped heading levels, you can specify how you want ePublisher to display skipped headings in the table of contents.
For example, assume that you have an ePublisher project that uses a Stationery file that specifies Heading 1, Heading 2, and Heading 3 as levels in the output table of contents. Then assume that in the source document, you skipped several Heading 2 levels. ePublisher displays an empty table of contents icon, similar to the following figure, in the location of the skipped Heading 2 levels unless you specify how you want to manage skipped heading levels in the generated table of contents.
You can specify the following behavior for table of contents where writers skipped headings:
If you want ePublisher to automatically insert empty table of contents entries for 'skipped heading levels, select the Don’t collapse value. The following figure shows a table of contents with this option selected.
If you want ePublisher to automatically insert labeled entries for skipped heading 'levels, select the Re-label value. ePublisher displays the heading text from the table of contents entry below the current entry as the table of contents label. The following figure shows a table of contents with this option selected.
If you want ePublisher to automatically remove empty table of contents entries 'and move the heading that follows an empty table of contents entry up a level to 'replace the skipped table of contents level, select the Smart collapse value. The following figure shows a table of content with this option selected.
If you want ePublisher to remove all skipped heading levels and table of contents 'entries and place all table of contents headings at the same level, regardless of the 'table of contents level specified in the Stationery, select the Fully collapse value. The following figure shows a table of contents with this option selected.
To specify table of contents settings for a target
On the Project menu, select the target next to Active Target for which you want to specify settings.
On the Target menu, click Target Settings. You must have target modification permissions to modify target settings. For more information, see “Customizing Target Settings” on page 325.
Under Table of contents, specify the appropriate values for the table of contents settings. For more information about table of contents settings and values, click Help.