Customization of the sectional tags

The section-base d.t.d. also contains many tags for customizing the rendering of sections and other section-related behaviour. The following two tags affect all sections:

<sectional-sep>

A macro for customizing the separator between the number of a section and its title. By default, we use two spaces.

<sectional-short-style>

A predicate which tells whether documents for this style are intended to be short or long. When sectional-short-style evaluates to true, then appendices, bibliographies, etc. are supposed to be special types of sections. Otherwise, they will be special types of chapters.

For each sectional tag x, the following tags are provided for customization:

<x-text>

A macro which displays the (localized) name of the sectional environment. For instance, <with|language|french|<appendix-text>> produces “Annexe”.

<x-title|title>

A macro for displaying the unnumbered section title.

<x-numbered-title|title>

A macro for displaying the numbered section title.

<x-display-numbers>

A predicate which specifies whether numbers will really be displayed. For instance, in the case of paragraph, this macro evaluates to false. Consequently, even though x-numbered-title does display the paragraph number, the main macro x will call x-title and not x-numbered-title, so that paragraph titles are not numbered.

<x-sep>

A macro for customizing the separator between the number of a section and its title. By default, we call sectional-sep.

<x-clean>

A hook for resetting all subcounters of the section.

<x-header|name>

A hook for changing the page headers.

<x-toc|name>

A hook for putting the section title into the table of contents.

Finally, the section-base d.t.d. provides rendering macros render-table-of-contents, render-bibliography, render-index and render-glossary, each of which takes two arguments: the name of the section and its body. It also provides the macros prologue-text, epilogue-text, bibliography-text, table-of-contents-text, index-text, glossary-text, list-of-figures-text and list-of-tables-text for customizing the names of special sections.

© 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".