The <toc> element indicates to the processing software that the author wants a table of contents generated at the particular location. If no @href attribute is specified on the <toc> element, an external processor might generate a table of contents at this location. If the @href attribute references a topic or map, that topic or map contains a manually created table of contents.

Content models

See appendix for information about this element in OASIS document type shells.

Inheritance

- map/topicref bookmap/toc

Example

See the example in bookmap.

Attributes

The following attributes are available on this element: Universal attribute group, Link relationship attribute group (with a narrowed definition of @href, given below), Attributes common to many map elements, @navtitle and @copy-to from Topicref element attributes group, outputclass, and @keyref.

@href: References a manual listing for the current element. See The href attribute for detailed information on supported values and processing implications. If no @href is specified, processors can choose to generate an appropriate listing for this element. All of the book listings operate in a similar manner; for example, <toc href="toc.dita"/> references a topic which contains a manual table of contents, while <toc/> indicates that a processor should generate the table of contents.