Skip to main content

Section 40.2 Numbering Options

How various items get numbered can be controlled by specifying levels. For pieces of content (e.g. <example>, <fn>, …) the level will be the number of separators in the number, usually periods. To fully understand these options, carefully read Section 26.2 and Section 26.3.

You can stop numbering divisions at some depth. For example, you may want your <book> (without parts) to have numbered <subsection>, but numbers on the few <subsubsection> is just too messy and not necessary. Then you would set the publisher file entry


to the value 3 to number <chapter>, <section>, and <subsection>, only. (Note this is the exception, you will get at most two separators in a division number in this case.) So you can think of this as the maximum level for numbers on divisions. Just be careful not to try to number other objects (described next) to a greater level, as that is impossible, and so will generate a warning and the default will be substituted.

For items within a division, various groups of objects are numbered consecutively, with a hierarchy given by a level. These numbers are controlled by


whose values should be integers (zero is a possibility) that do not exceed the maximum level specified for divisions.

Chapters of a <book> may start numbering from something other than one. This feature is not available in a book with structural parts (rather than decorative parts). Read about this at the end of Section 26.3 and Best Practice 26.3.1. If you still want to proceed, then set the publisher file entry


to the desired value of the first chapter.

A <book> with <part> may have the parts numbered to reflect two different structures, decorative or structural. Set the publisher file entry


to decorative (the default) or structural.

For more on divisions, and their numbering see Section 4.6.