You can customize how a non-DITA structured document is displayed in the TOC pane in either a Workbench Browse view or in the Astoria Reviewer interface.
When you view a non-DITA structured document, a Table of Content (TOC) pane aids in organizing information so that you can quickly access the elements of interest. It also improves performance by not requiring the entire structured document to be loaded into the content pane by default.
You can specify which elements are a part of the TOC pane, and you can select to display only those elements in the structured document that are of interest. When specifying TOC settings, Astoria allows the flexibility for the TOC to apply to:
- The entire repository (a global value specified at the Cabinets level)
- All documents that use a certain DTD
- All structured documents in a certain cabinet or folder
- A specific document
Because they deal with tags, in most cases TOC settings are specified at the DTD level. However, if specified at a document level, those settings prevail. If not specified at the document or DTD level, the order of precedence is:
- an ancestor folder of the DTD
- an ancestor folder of the document
- the global value
Note: DITA maps are displayed with a TOC panel that is based on the structure of the map, so TOC settings do not apply. Astoria uses the toc attribute value to determine whether a reference (for example, a topicref) should appear in the TOC panel. The toc attribute value can be inherited from an ancestor.