Tables of Contents List
A list of table of contents format objects configured for the stylesheet. This list displays when you choose > >
When this list is active, the
Insert Table of Contents button
appears in the
Standard toolbar, allowing you to create a new table of contents format object in the list.
The Properties area of the Tables of Contents list contains the following options for you to edit table of contents format objects. You can also control whether the elements in your tables of contents should be employed in certain output formats, such as being used as bookmarks in PDF output or being included in any table of contents created for chunked HTML output.
• Scope - Lists the elements for which you can specify a table of contents, allowing you to generate a table of contents every time that element appears in your document. You can also choose to create a table of contents for the whole document. The list contains all elements in the stylesheet that are mapped to Block, Division, Document or Unstyled styles, in alphabetical order. The default scope is Whole Document.
| When you select a recursive division element for your table of contents scope, only the outermost occurrences of that element are included in the table of content. |
• Use for PDF bookmarks - Indicates whether the entries in this table of contents should also be output as bookmarks in your final PDF file. If you have multiple tables of contents format objects for your document type, you can enable this option for any or all of those objects. The resulting bookmark list will be the union of all the tables of contents format objects defined for your document type that have this option selected, with duplicate entries removed, even if those have not been referenced from an element context. This option is unchecked by default.
Use the Limit PDF bookmark levels opened initially (APP and FOSI only) option in the Print/PDF tab of the Stylesheet Properties dialog box to control the number of levels of bookmark that will be open in an output PDF.
If you have this option checked for FOSI output you may see the error message shown below in the field at the bottom of the properties area:
Some titles will not appear in PDF bookmarks. Click Customize button for details
This message means that some title contexts set to appear in the TOC do not specify a direct parent. These contexts will not produce bookmarks in output generated by FOSI. For example, the context title everywhere is not acceptable, but title in book is permitted. Click the Customize button to open the Customize Table of Contents dialog box, in which you can define the contexts that should be included in a TOC.
If you have this option checked for PDF published via the XSL-FO engine, PDF bookmarks generated will always consist of the number followed by the title contents, irrespective of any other content that may be associated with the title when it is displayed in a TOC. Only the fact that a given title context is included in a TOC that is being used for PDF bookmarks is relevant to the XSL-FO output - all formatting details associated with the context in the TOC are ignored when using the XSL-FO engine. Neither generated text associated with the title nor any label or punctuation associated with the title number will be included in this title's entry in a bookmark. In addition, the title number may be displayed in the bookmark even if it is set to be suppressed in a TOC.
| Index term, footnote, and other hidden elements that are included in a division title will be output in the PDF bookmark for the division. You should ensure that you place elements of this type in the first element following the title to avoid them being displayed in the bookmark. |
• Use for chunked HTML outputs (EPUB, HTML Help, and Web) - Indicates whether the entries in this table of contents should be included in the online TOC in EPUB, HTML Help, or Web output. If this option is checked the resulting TOC will be displayed in a separate frame in the HTML file or web page. If you have multiple tables of contents format objects for your document type, you can enable this option for any or all of those objects. The resulting online TOC will be the union of all the tables of contents format objects defined for your document type that have this option selected, with duplicate entries removed, even if those have not been referenced from an element context. This option is unchecked by default.
When generating TOCs for EPUB output with this option, only titles at levels 1–3 in the document hierarchy will be included.
• Customize Title Contexts - Opens the Customize Table of Contents dialog box, allowing you to select any title context currently configured in the stylesheet for inclusion in the table of contents.
• Format - Opens the Table of Contents Format dialog box, in which you can change the appearance of the table of contents.
