O'Reilly logo

DocBook 5: The Definitive Guide by Richard L. Hamilton, Norman Walsh

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

toc — A table of contents

Synopsis

toc ::= ((((title? & titleabbrev?), infodb.titleforbidden.info) | info db.titleonly.info), (annotation | bridgehead | remark | revhistory | Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)*, (tocdiv | tocentry)*)

Additional constraints

  • If this element is the root element, it must have a version attribute.

Description

The toc element defines a table of contents, or more generally, a list of titles in a document.

Processing expectations

Formatted as a displayed block.

In real life, tocs are usually generated automatically by the presentation system and never have to be represented explicitly in the document source.

See Also

tocdiv, tocentry

Examples

<book xmlns='http://docbook.org/ns/docbook'> <title>DocBook: The Definitive Guide</title> <subtitle>TOC Markup Example</subtitle> <toc> <title>Table of Contents</title> <tocdiv> <title>Preface</title> <tocentry>Why Read This Book?</tocentry> <tocentry>This Book's Audience</tocentry> <!-- ... --> </tocdiv> <tocdiv> <title>Part I. Introduction</title> <tocdiv> <title>Chapter 1. Getting Started with DocBook</title> <tocdiv> <title>A Short DocBook History</title> <tocentry>The HaL and O'Reilly Era</tocentry> <tocentry>The Davenport Era</tocentry> <tocentry>The OASIS Era</tocentry> ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required