4.3.4 Numbered Paragraphs
In some instances, it is desirable to specify a list not as a
structural element comprising of several list items, but to determine on a
per-paragraph level whether the paragraph is numbered, and at which level. To
facilitate this, the <text:numbered-paragraph>
element allows the numbering of an individual paragraph, as if it was part of a
list at a specified level.
Numbered paragraphs may use the same continuous numbering
properties that list items use, and thus form an equivalent, alternative way of
specifying lists. A list in <text:list>
representation could be converted into a list in <text:numbered-paragraph>
representation and vice versa.
<define name="text-numbered-paragraph">
<element
name="text:numbered-paragraph">
<ref
name="text-numbered-paragraph-attr"/>
<optional>
<ref
name="text-number"/>
</optional>
<choice>
<ref
name="text-p"/>
<ref
name="text-h"/>
</choice>
</element>
</define>
A numbered paragraph can be assigned a list level. A numbered
paragraph is equivalent to a list nested to the given level, containing one
list item with one paragraph. If no level is given, the numbered paragraph is
interpreted as being on level 1.
<define name="text-numbered-paragraph-attr"
combine="interleave">
<optional>
<attribute
name="text:level" a:defaultValue="1">
<ref
name="positiveInteger"/>
</attribute>
</optional>
</define>
As a numbered paragraph combines the functionality of a
(possibly nested) list with a single list item, it can also use the attributes
of those elements.
<define name="text-numbered-paragraph-attr"
combine="interleave">
<ref
name="text-list-attr"/>
</define>
<define name="text-numbered-paragraph-attr"
combine="interleave">
<ref
name="text-list-item-attr"/>
</define>
The text of a formatted number can be included in a <text:number> element. This text can be used by
applications that do not support numbering, but it will be ignored by
applications that support numbering. See also section 4.1.1.