List Item Number Dialog Box

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

Note that some number style and number position properties may only have the desired effect in HTML outputs if the selected output is configured to format list items 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 list item itself and in any references to the list item. If you do not want the punctuation to appear in references to the list item, 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)

Support for these numbering styles in HTML outputs varies by browser. Please refer to Numbering List Items for a summary of the differences between browsers.

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

◦ (Parent list element): number the first occurrence of the current list item in its parent list element as 1, and continue numbering the current list item items in sequence until a new parent list element starts.

◦ (No Restart): continue numbering whenever the list item appears and regardless of the parent list element to which it belongs.

• Previous level number - Specifies the element 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 element being styled):

◦ Previous: for first level list items, add the number of the direct parent of the list to which the list item belongs. For non-first level list items, add the number of the list item at the previous level.

◦ Select a specific element from the list supplied - the list contains all numbered elements that are valid ancestors of the list whose list items are 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 list item, for example Step. 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 list. The button is only accessible if an XPath expression has been entered in the field.

◦ 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 in 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, and click the Edit button next to the Before-text field.

• Alignment - Defines how numbers align relative to other list item numbers. For example, if you select Left alignment and you have steps 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 list item being styled, but does not appear in references to that list item, for example cross references.

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

• Tab to - Specifies the position at which list item content starts after the 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 in this field will have different results in the various output formats, if the label of the list item (the number plus any suffix) is longer than the Tab to value allowed:

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

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

◦ HTML outputs (when the stylesheet property Format list items as tables is selected): the table column for the list item body is determined by the value set in the Tab to field, thus setting the right side of the list item label field. If the 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.

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

• Indent following lines - Specifies the amount by which to indent text on following lines if the list item 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