Skip to main content
Version: DocBook V4.5

itemizedlist

itemizedlist — A list in which each entry is marked with a bullet or other dingbat

Synopsis

Content Model

itemizedlist ::=
(blockinfo?,
(title,titleabbrev?)?,
(caution|important|note|tip|warning|literallayout|programlisting|
programlistingco|screen|screenco|screenshot|synopsis|
cmdsynopsis|funcsynopsis|classsynopsis|fieldsynopsis|
constructorsynopsis|destructorsynopsis|methodsynopsis|
formalpara|para|simpara|address|blockquote|graphic|graphicco|
mediaobject|mediaobjectco|informalequation|informalexample|
informalfigure|informaltable|anchor|bridgehead|remark|
highlights|abstract|authorblurb|epigraph|indexterm|beginpage)*,
listitem+)

Attributes

Common attributes

Name

Type

Default

mark

CDATA

None

spacing

Enumeration:

compact

normal

None

Description

In an ItemizedList, each member of the list is marked with a bullet, dash, or other symbol.

Processing expectations

Formatted as a displayed block.

DocBook specifies neither the initial mark nor the sequence of marks to be used in nested lists. If explicit control is desired, the Mark attribute should be used. The values of the Mark attribute are expected to be keywords, not representations (numerical character references, entities, and so on.) of the actual mark.

In order to enforce a standard set of marks at your organization, it may be useful to construct a customization layer that limits the values of the Mark attribute to an enumerated list. See Chapter 5, Customizing DocBook.

Future Changes

Introductory material may appear before the first list item.

Attributes

mark

Mark contains a keyword indicating the type of mark to be used on items in this ItemizedList. DocBook does not provide a fixed list of appropriate keywords.

spacing

Spacing indicates whether or not the vertical space in the list should be minimized.

Examples

<!DOCTYPE itemizedlist PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<itemizedlist mark='opencircle'>
<listitem>
<para>
TeX and LaTeX
</para>
</listitem>
<listitem override='bullet'>
<para>
Troff
</para>
</listitem>
<listitem>
<para>
Lout
</para>
</listitem>
</itemizedlist>
  • TeX and LaTeX

  • Troff

  • Lout

For additional examples, see also highlights, para, xref.