Generating TOCs and other lists in structured documents

Although the steps for generating TOCs and lists in structured documents are the same as for unstructured documents, consider the following additional points:

• A generated list is initially unstructured, but you can add structure to it. If a generated list is structured, you’ll lose the structure every time you regenerate it. Do not add structure to a list until it is in its final version.

• The items in the scroll lists vary depending on the type of list you’re gathering. For example, the element and paragraph styles in the source document appear for a table of contents. Paragraph styles appear after element styles and are preceded by a paragraph symbol (¶). For a list of references, the available reference types appear.

• Some elements may have context labels that provide information about the element’s location in the structure. For example, if <Section> elements can be nested within other <Section> elements, context labels might identify whether the elements are first-, second-, or third-level sections.

Figure 1. Context labels

• If an element uses context labels, a <no label> entry also appears in the scroll list for occurrences not described by the labels. In the example above, Section (<no label>) represents <Section> elements that are at a fourth level or lower in the document.

• If an element has more than one paragraph, only text from the first paragraph will appear in the generated list. For example, the first paragraph within a <Section> element—usually its Head—will appear.

• The first time you generate a list (if you don’t use a template), it uses the page layout (master pages) of the first non-generated document in the book, and all entries look the same. The list also has element definitions from the source document.