Numbering schemes

You can choose to structure the leaves using a partition based numbering scheme or a section based numbering scheme. In a partition based numbering scheme the leaves are organised into one or more leaf groups. In a section based numbering scheme the leaves are organised into one or more leaf sections. The selected numbering scheme applies to the entire partition. Leaf groups cannot contain leaf sections, and leaf sections cannot contain leaf groups.

Partition based numbering

In a partition based numbering scheme, the folio numbering begins at a user defined start page, and the pages are numbered sequentially. The page folio is a numeric identifier consisting of a primary folio index and up to four additional point page levels.

Leaves can be organised into one or more leaf groups. Each leaf group can be optionally separated from the following leaf group by a gap in the folio numbering sequence. This technique is known as gapping. Gapping helps to minimize the total number of point pages by reserving a folio range into which a leaf group may expand if necessary.

Leaf groups are usually associated with a major document structural unit, such as a chapter, a table of contents, or an index. For example, consider a document consisting of a number of chapters, with each chapter beginning on a right-hand page and numbered with consecutive folios. There is no room for expansion:

When a leaf gap of 100 is applied by starting a new leaf group on the mapping for the <chapter> tag, the folio numbering sequence will look like this:

There is now room for expansion at the end of each chapter.

Leaf groups and leaf gaps can only be declared in a mainwork. Once established, the number of leaf groups and the gap size remains unchanged. For this reason, if you decide to organise your content using leaf groups, first identify the parts of your content that can be associated with a leaf group, and estimate an appropriate gapping size. The default leaf gapping is 100 pages. You can use the <leaf-settings> command to change the default gap size.

Section based numbering

In a section based numbering scheme, the document leaf set is organised into any number of leaf sections. The folio numbering for each leaf section begins at 1, and each leaf folio is numerically greater than the previous leaf folio in the same section. Leaf sections can be created, inserted or removed in any release.

Each leaf section is associated with a unique section prefix that identifies all pages within that section. All leaf sections starts on a recto page and are numbered from 1.

Point pages may be created between existing leaves within a section, but changes at the end of the section will always result in the creation of additional leaves.

Page folios consist of two components — the section prefix and a sequence number. The section prefix consists only of characters within the US-ASCII character set. The sequence number is a numeric identifier consisting of a primary folio index and up to four additional point page levels.

Leaf sections are often associated with a major document structural unit, such as a chapter, section, table of contents, or an index. For example, consider a document consisting of a number of chapters, with each chapter containing one or more sections. Each section starts a new right-hand page. This diagram shows how the leaves are organized and labelled:

Now suppose that each <chapter> tag declares an attribute that identifies the chapter number, and each <section> tag declares an attribute that identifies the section within that chapter. In the TopLeaf mappings you can capture the chapter identifier as {ChapterID}, and the section identifier as {SectionNum}.

To create or start a leaf section, declare the section prefix by including a <leaf-properties/> command in the custom content of a mapping triggered at the beginning of the section:

<leaf-properties section-prefix="{ChapterID}-{SectionNum}."/>

A section remains in force until the end of the document or until a new section prefix is declared. The page folio can be referenced by including the <folio/> command within a page header or footer. In some publication styles it may be necessary to suppress either the section prefix or page sequence number. The following example shows how the <folio/> command can be used to reference a page folio without the section prefix:

<folio prefix=”no” />