itemizedlist

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

Synopsis

itemizedlist ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • mark (NMTOKEN)
  • spacing (enumeration)
    • “compact”
    • “normal”

Additional Constraints

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

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, etc.) of the actual mark.

DocBook does not specify a set of appropriate keywords.

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.

Attributes

Common attributes and common linking attributes.

any attribute

Any attribute in any other explicit namespace

mark

Identifies the type of mark to be used on items in this list

spacing

Specifies (a hint about) the spacing of the content

Enumerated values:
“compact”

The spacing should be "compact".

“normal”

The spacing should be "normal".

Parents

These elements contain itemizedlist: abstract, acknowledgements, annotation, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption (db.caption), caution, chapter, colophon, constraintdef, cover, danger, dedication, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, important, index, indexdiv, informalexample, informalfigure, itemizedlist, legalnotice, listitem, meta (db.meta.content), msgexplan, msgtext, note, orderedlist, para, partintro, preface, procedure, qandadiv, qandaset, question, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, result, revdescription, sect1, sect2, sect3, sect4, sect5, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, td, textobject, th, tip, toc, tocdiv, topic, variablelist, warning.

Children

The following elements occur in itemizedlist: address, anchor, annotation, bibliolist, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, danger, destructorsynopsis, enumsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalgroup, formalpara, funcsynopsis, glosslist, important, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, listitem, literallayout, macrosynopsis, mediaobject, methodsynopsis, msgset, note, orderedlist, packagesynopsis, para, procedure, productionset, programlisting, programlistingco, qandaset, remark, revhistory, screen, screenco, screenshot, segmentedlist, sidebar, simpara, simplelist, synopsis, table (db.cals.table), table (db.html.table), task, tip, title, titleabbrev, typedefsynopsis, unionsynopsis, variablelist, warning.

See Also

Related elements: calloutlist, listitem, orderedlist, segmentedlist, simplelist, variablelist.

Examples

 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |<title>Example itemizedlist</title>
   | 
   |<itemizedlist mark='opencircle'>
 5 |  <listitem>
   |    <para>TeX and LaTeX
   |    </para>
   |  </listitem>
   |  <listitem override='bullet'>
10 |    <para>Troff
   |    </para>
   |  </listitem>
   |  <listitem>
   |    <para>Lout
15 |    </para>
   |  </listitem>
   |</itemizedlist>
   | 
   |</article>

  • TeX and LaTeX

  • Troff

  • Lout