The <leaf-settings/> command

This command allows you to override the default looseleaf settings when processing a full looseleaf partition.

Where allowed

The $document mapping.

Range of effect

The entire document.



Specifies the number (folio) to be assigned to the first leaf group in the partition;


Specifies the size of the leaf gap applied after each leaf group


Indicates how the gapping is to be applied. If yes, then the gap is added at the end of each leaf group, if no then the gap is relative to the start of the group

For example, say the gapping is set to 100 and the current group starts on page 501 and ends on page 628. If slide is set to yes, then the 100 page gap is added after the group end, so the following group will start on page 729. If no, then the gap is added to the group start as often as necessary. So the next group would start on the next hundred page boundary, which is 701.


Declares the folio separator string inserted between the partition identifier and the page folio, or the partition link identifier and the page link folio. The folio separator string will not appear if the content of the partition identifier or link identifier is defined as a null (empty) string. The default folio separator is an &mdash;.


Specifies the point page level separator TopLeaf uses when rendering a full looseleaf page folio that declares one or more point page levels.

The point page level separator identifies either a single punctuation character inserted before each point page level or a bracket character pair that encloses each point page level. The exception is the 999(ab) page folio format, which supports a primary folio index and one additional point page, with the level separator specifying the bracket character pair enclosing a single point page level.

The following table explains how to render some common stroke page formats:

To produce this page folio output ... Select this page folio format ... And define this point page level separator ...
999/9/9 999/9/9 /
999.1.1 999/9/9 .
999,1,1 999/9/9 &#44; (or &x#2c;)
999(1) 999/9/9 (
999(a) 999(a) (
999[a] 999(a) [
999{a} 999(a) &lcub; (or &x#7b;)
999<a> 999(a) &lt;(or &#60;)
999a 999(a) "" (a null string)
XII XII/9/9 /
xii.9.9 xii/9/9 .
[Note] Note
  1. With the exception of a limited number of reserved characters you cannot use character references or entity references to specify a point page level separator character.

  2. The point page level separator is always defined as a single character.

  3. The default point page level separator character is a /

  4. For more information about looseleaf typesetting, see the User Guide.


When a leaf boundary is positioned within the scope of scanned document content, TopLeaf composes the leaves sharing that boundary as a single unit, irrespective of whether the content of either leaf is changed or the leaves are manually included. In the case where a leaf is changed or manually included, and a leaf boundary is positioned within the scope of scanned document content, TopLeaf applies an automatic leaf inclusion to the adjacent leaf. If you need to disable automatic leaf inclusion for scanned content, set this value to legacy.


Declares the maximum number of point page levels permitted. TopLeaf automatically renumbers any leaf group or leaf section when the number of point pages in that group or section exceeds this value. The default is 4.


Sets the maximum amount of interword space permitted within the last line of a leaf, expressed as a percentage of the column width. Where a published leaf boundary is positioned within a justified paragraph, subsequently adding or removing content before that boundary may cause the last line to be rendered with excessive interword spacing. The last line of a leaf will be set ragged right if the percentage of interword spacing in that line exceeds the specified value. The default is 33%.


When you compose the first release after a manual leaf split, unexpected overflow leaves are listed as a messages in the typesetting log file. If you want TopLeaf to generate a warning when unexpected overflow leaves are created, set this value to yes.