Section 45.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.
For more on divisions, and their numbering see Section 4.6.
Subsection 45.2.1 Division Level Options
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 publication file entry/publication/numbering/divisions/@level
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. The levels of the other objects (described in Subsection 45.2.2) can never exceed this maximum. If an entry in your publication file asks for a greater level, or is not a non-negative integer, you will get a warning and the default value will be used instead. When you make no request at all there is no warning: each default is determined by the type of your document, and is automatically reduced to the divisions level when necessary, on the presumption that this is just what you expect.Subsection 45.2.2 Block, Equation, and Footnote Level Options
For items within a division, various groups of objects are numbered consecutively, with a hierarchy given by a level. These numbers are controlled by
/publication/numbering/blocks/@level /publication/numbering/equations/@level /publication/numbering/footnotes/@level
whose values should be integers (zero is a possibility) that do not exceed the maximum level specified for divisions.
By default that “blocks” sequence also numbers four further groups—
<project>-like objects, the figure-like objects (<figure>, <table>, <listing>, <list>), inline <exercise>, and the open problems (<openproblem>, <openquestion>, <openconjecture>). Any one of these may instead run on its own independent sequence of serial numbers, by setting the matching @distinct switch/publication/numbering/projects/@distinct /publication/numbering/figures/@distinct /publication/numbering/exercises/@distinct /publication/numbering/openproblems/@distinct
to
yes (the default is no). When a group runs distinct, the hierarchy of its independent numbers is set by its own @level
/publication/numbering/projects/@level /publication/numbering/figures/@level /publication/numbering/exercises/@level /publication/numbering/openproblems/@level
which is ignored while the group shares the blocks count. For why blocks otherwise share a single sequence, and which groups make sense to separate, see Section 26.3.
Subsection 45.2.3 Chapter Start Options
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.2. If you still want to proceed, then set the publication file entry/publication/numbering/divisions/@chapter-start
to the desired value of the first chapter.
Subsection 45.2.4 Part Structure Options
A
<book> with <part> may have the parts numbered to reflect two different structures, decorative or structural. Set the publication file entry/publication/numbering/divisions/@part-structure
to
decorative (the default) or structural.When a
<book> is designed to have structural parts, then there is an expectation that the part divisions are important or relevant (at least moreso than in the case of decorative parts). Then, to choose to number objects (blocks, equations, etc.) at level 0, crossing part boundaries, strikes us as an odd choice. So odd that there is a small bug at issue #1650, which might be solved by simply banning this combination.
You have attempted of activities on this page.
