Division Title Number Dialog Box

This dialog box displays if you select a context or condition for the title of a division from the Elements list, define it as a numbered division by selecting the Number option in the Generated text category, then click the Details button to format the number.

Note that some number position properties have no effect in chunked HTML outputs (EPUB, HTML Help, and Web). Refer to Differences in Output Support for information. This is also the case with HTML File output, unless it is configured to format titles as tables. This setting is made in the HTML tab of the Stylesheet Properties dialog box. Please refer to Stylesheet Properties — HTML File for information.

If you require punctuation (non-alphanumeric) characters before or after the number, or before or after the previous level number indicated, for example, #.1 or (1), enter it in this field. Note that if you enter punctuation here it will appear both in the title itself and in any references to the title. If you do not want the punctuation to appear in references to the title, for example in cross references, enter it in the Suffix (does not appear in references) field instead.

This field displays a number character (#) if Arbortext Styler is unable to detect a number for the previous element when one has been requested in the Previous level number field.

Selecting this option enables you to perform operations such as having an automatically generated label for the element that can be cross referenced, or cross referencing the element, without having to display the number.

Choosing one of the last three styles causes the number to be padded on the left by two, three, or four spaces respectively. If you have entered an XPath expression in the XPath override for current level option that returns a string, this option is disabled.

◦ 一, 二, 三... (Chinese - simp-chinese-informal numbering scheme, implemented to support the Kanji numeric 1 numbering scheme)

• Restart - Launches the Numbering Restart dialog box, in which you can specify the element at which to restart numbering. The available options are:

◦ (Previous division level): number the first occurrence of the current division title in its parent division element as 1, and continue numbering the current division titles in sequence until a new parent division level starts.

Selecting this option will give you compound numbering based on your division settings. For example, if you have specified compound numbering for the divisions, the numbering of the sections in your document could appear as follows:

◦ (No restart): continue numbering whenever the division title appears and regardless of the parent or division level to which it belongs.

◦ Select a specific element from the list supplied: the list contains all element contexts styled as Division, Block, or Document that are permitted as ancestors of the current title's division.

• Previous level number - Specifies the element in the previous division level whose number should be shown before the number of the current element, if compound numbering is required for the current level. The following options are available (note that the list does not include the division that is the parent of the current title context):

◦ (Previous): add the number of any element with a higher division level that is entered as the direct parent of the current element in the document

◦ Select a specific element from the list supplied: the list contains all numbered elements that are valid ancestors of the division whose title is being styled

Publishing errors will occur if you choose the second or third option and the previous element is not numbered.

The Number format field will display a number character (#) if Arbortext Styler is unable to detect a number for the previous element as set here.

• Label - Allows you to enter a text string to be displayed before the number in the title, for example Chapter . To localize the label, use the Advanced Edit button.

• Advanced Edit - Opens a Generated Text Editor window, in which you can set the position of the label with reference to the number. You may also configure translation settings for the label. Refer to Maintaining Translations of Generated Text for further information on how to translate content.

By default, the label is placed before the number. These may be swapped round either in this dialog or in the resulting translation.

You are not permitted to delete the number or add text to both sides of the number. In addition, no font or spacing controls are provided in this instance of the generated text editor. Set the font using the Font button in the number dialog.

• XPath override for current level - Allows you to enter an XPath expression to determine the number or maker for the current level, rather than it being judged automatically based on content.

• Delete - Removes the expression from the Edit XPath Override for Current Level field, thus reverting to content based level calculation for the division. The button is only accessible if an XPath expression has been entered in the field.

◦ custom counter name: Select an existing counting sequence, within which this element should be included. Note that multiple elements can be included in a single counting sequence - if other elements are included in the selected sequence the element names will be displayed in the Counted with field.

• Keep number at beginning of line - Determines whether the number is placed at the beginning of the line. This option is checked by default. When this box is not checked, the number is still automatically placed at the beginning of the line (see the entry for the generated text for the title in the Before-text field on the Generated text category for the title element). You can subsequently click Edit for the generated text field to add content, or other information, before the number using the Generated Text Editor.

The Alignment and Follow number with controls are not available when this option is deselected. The Font button is also not available, but you can use the Format menu in the Generated Text Editor to modify the number's font.

Note that this button is disabled if the Keep number at beginning of line option is unchecked, for example if you are numbering an inline element. If you wish to apply font settings, use one of the following options:

1. In the Generated Text Editor, choose the Format > Touchup > Font menu option. You will be presented with the Modify Font dialog box.

To invoke the Generated Text Editor, navigate to the Generated text category for the numbered element. Click the Edit button next to the Before-text field.

• Alignment - Defines how numbers align relative to other division title numbers. For example, if you select Left alignment and you have divisions numbered 1 through 10, the 1 in both numbers align. If you select Right alignment, the 0 in the number 10 aligns with the 1.

• Align at - Specifies the position at which left or right alignment of the number occurs, relative to the left margin. See the note at the end of this description for input options.

• Suffix (does not appear in references) - Defines punctuation that appears after the number in the title being styled, but does not appear in references to that title, for example cross references or table of contents entries.

• Follow number and suffix with - Specifies the amount of space between the number and the title content that follows. The available options are:

• Tab to - Specifies the position at which title content starts after the title number, used when the Follow number with field is set to Tab. See the note at the end of this description for input options.

Note that a setting made in this field will have different results in the various output formats, if the label of the title (the number plus any suffix) is longer than the Tab to value allowed:

◦ FOSI outputs: the text of the title immediately follows the extra long label, with no intervening space. The long label pushes the title body text forward as required.

◦ XSL-FO outputs: the text of the title starts where it is meant to start (at the position identified by the Tab to value) even if the label is extra long. The title text will overwrite the label.

◦ HTML outputs (when the Format titles as tables stylesheet property is selected): the table column for the title body is determined by the value set in the Tab to field, thus setting the right side of the title label field. If the title label doesn't fit in the given field it will break, if possible. Any label text that still does not fit into the field will not be visible in the browser.

Note that, for chunked HTML outputs (EPUB, HTML Help, and Web), titles are never output as tables. In these instances any Tab to value is ignored and a single space will be output after the label, regardless of the size of the label.

◦ RTF: output: similar to the effect seen for FOSI outputs except that a space is included between the label and the start of the title body text.

• Indent following lines - Specifies the amount by which to indent text on following lines if the title text wraps to the next line(s). See the note at the end of this description for input options. To left align the text on the first and following lines, specify the same value in this field as you specify in the Tab to field.

• Counted with - Provides a list of other elements in the stylesheet that are included in the same counting sequence as the element being styled. Note that the window only appears if the Custom counter field has a value other than (none).

The Align at, Tab to, and Indent following lines fields of this dialog box allow you to either type an arbitrary size in the field or choose a defined size by selecting from the list of Size objects configured for your stylesheet. For the latter option, click the Select Size button The Select Size icon - 3 horizontal lines, a green double ended arrow and a green x, all bounded by vertical lines, with a black down arrow to their right

The Select Size icon - 3 horizontal lines, a green double ended arrow and a green x, all bounded by vertical lines, with a black down arrow to their right

next to the field for which you wish to set the measurement and select the name of the required Size object from the resulting list. Once you have selected a Size object the measurement it defines will be displayed wrapped in angle brackets (< > characters) in the relevant field. For example, the Size object InchSize defines a measurement of 1.00in:

This is an image of the Top field with the InchSize Size listed in the Size definition list activated for the measurement, and the measurement <1.00in> shown in the field