DocBook 5.1: The Definitive Guide  (Version 1.5.3 for DocBook 5.1)

orderedlist

orderedlist — A list in which each entry is marked with a sequentially incremented label.

Synopsis

orderedlist ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • At most one of:
    • continuation (enumeration)
      • “continues”
      • “restarts”
    • startingnumber (integer)
  • inheritnum (enumeration)
    • “ignore”
    • “inherit”
  • numeration (enumeration)
    • “arabic”
    • “upperalpha”
    • “loweralpha”
    • “upperroman”
    • “lowerroman”
  • spacing (enumeration)
    • “compact”
    • “normal”

Additional Constraints

  • If this element is the root element, it must have a version attribute.

Description

In an orderedlist, each member of the list is marked with a numeral, letter, or other sequential symbol (such as Roman numerals).

Processing expectations

Formatted as a displayed block.

The numeration attribute indicates the desired numeration. If it is not specified, Arabic numerals (1, 2, 3, …) are to be used.

Note

The actual characters used in alphabetic numeration may be locale sensitive. Where the sequence “a”, “b”, “c” might be selected in an English locale, “ア”, “イ”, “ウ” might be selected if Katakana was implied by the current locale.

The continuation attribute indicates how numbering should begin relative to the immediately preceding list. If it is not specified, numbering is to be restarted at 1.

Note

The preceding list is not required to be in the same parent. That is, a list in one chapter may be continued in the next, or indeed arbitrarily later in the document, provided no other list intervenes.

The inheritnum attribute indicates how items in nested lists should be numbered. If it is not specified, numbering is to ignore list nesting. Inherited numeration creates compound list item numbers.

If inheritnum is “inherit”, then the third item of a list inside the second item of a list inside the fourth item of a list might be enumerated as “4.2.3”. If inheritnum is “ignore”, then it would be simply “3” (with the numeration attribute handling the actual format of the numbers).

In nested lists, some publishers prefer to use Arabic numbers throughout (4.3.2) while others prefer to step through a sequence of numerations (4.b.iii). DocBook does not specify the sequence of numerations.

Attributes

Common attributes and common linking attributes.

continuation

Indicates how list numbering should begin relative to the immediately preceding list

Enumerated values:
“continues”

Specifies that numbering should begin where the preceding list left off

“restarts”

Specifies that numbering should begin again at 1

inheritnum

Indicates whether or not item numbering should be influenced by list nesting

Enumerated values:
“ignore”

Specifies that numbering should ignore list nesting

“inherit”

Specifies that numbering should inherit from outer-level lists

numeration

Indicates the desired numeration

Enumerated values:
“arabic”

Specifies Arabic numeration (1, 2, 3, …)

“upperalpha”

Specifies upper-case alphabetic numeration (A, B, C, …)

“loweralpha”

Specifies lower-case alphabetic numeration (a, b, c, …)

“upperroman”

Specifies upper-case Roman numeration (I, II, III, …)

“lowerroman”

Specifies lower-case Roman numeration (i, ii, iii …)

spacing

Specifies (a hint about) the spacing of the content

Enumerated values:
“compact”

The spacing should be "compact".

“normal”

The spacing should be "normal".

startingnumber

Specifies the initial line number.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example orderedlist</title>

<orderedlist numeration="lowerroman">
  <listitem>
    <para>One</para>
  </listitem>
  <listitem>
    <para>Two</para>
  </listitem>
  <listitem>
    <para>Three</para>
  </listitem>
  <listitem>
    <para>Four</para>
  </listitem>
</orderedlist>

</article>
  1. One

  2. Two

  3. Three

  4. Four