Using sectional tags

The section-base d.t.d. provides the standard tags for sections, which are the same as in LaTeX. Most sectional tags take one argument: the name of the section. The intention of the following tags is to produce numbered sections:

<part|title>

<chapter|title>

<section|title>

<subsection|title>

<subsubsection|title>

<paragraph|title>

<subparagraph|title>

<appendix|title>

The intention of this macro is to produce a numbered title for a part (resp. chapter, section, subsection, etc.). The numbering is not required, but merely an intention: the paragraph and subparagraph tags are usually not numbered and some styles (like the generic style) do not produce numbers at all.

The tags part*, chapter*, section*, subsection*, subsubsection*, paragraph*, subparagraph* and appendix* can be used for producing the unnumbered variants of the above tags.

By default, all sectional only produce the section title. When using the experimental package structured-section, all sectional tags are enriched, so that they take the body of the section as an optional argument. Moreover, an additional tag rsection is provided in order to produce recursively embedded sections. For instance, an rsection inside a section behaves like a subsection. In the future, all list items should become structured.

The section-base d.t.d. also provides the following sectional environments with automatically generated content

<bibliography|aux|style|file-name|body>

This macro is used for producing bibliographies. The first argument aux specifies the auxiliary channel with the data for generating the bibliography (bib, by default). The arguments style and file-name contain the bibliography style and the file with the bibliographic database. The body argument corresponds to the automatically generated content.

<table-of-contents|aux|body>

This macro is used for producing tables of contents. The first argument aux specifies the auxiliary channel with the data for generating the bibliography (toc, by default). The body argument corresponds to the automatically generated content.

<the-index|aux|body>

Similar to table-of-contents but for indices and default channel idx.

<the-glossary|aux|body>

<list-of-figures|aux|body>

<list-of-tables|aux|body>

Similar to table-of-contents but for glossaries (default channel gly), lists of figures (default channel figure) and lists of tables (default channel table).

The above tags also admit the variants bibliography*, table-of-contents*, the-index* and the-glossary* with an additional argument name before body, which specifies the name of the section. For instance, the the-glossary* was formerly used for lists of figures and lists of tables.

© 1998–2002 Joris van der Hoeven
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".