itemizedlist
itemizedlist — A list in which each entry is marked with a bullet or other dingbat.
Synopsis
itemizedlist ::= ![[-]](figs/web/nav/down.gif)
![[+]](figs/web/nav/right.gif)
- Sequence of:
- One of:
- Zero or more of:
bridgeheaddialoguedramapoetryremarkrevhistory- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
- List elements
- Paragraph elements
- Publishing elements
- Technical elements
- Verbatim elements
- One or more of:
- One of:
Attributes
Common attributes and common linking attributes.
Additional attributes:
- mark (NMTOKEN)
- spacing (enumeration)
- “compact”
- “normal”
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 @@LINKEND: app-customizing@@.
Attributes
Common attributes and common linking attributes.
- 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: acknowledgements, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption, chapter, colophon, cover, dedication, dialogue, drama, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, index, informalexample, informalfigure, itemizedlist, legalnotice, linegroup, listitem, note, orderedlist, para, partintro, poetry, preface, procedure, qandadiv, qandaset, question, revdescription, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, textobject, toc, variablelist.
Children
The following elements occur in itemizedlist: address, anchor, bibliolist, blockquote, bridgehead, calloutlist, dialogue, drama, epigraph, equation, example, figure, formalpara, glosslist, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, listitem, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandaset, remark, revhistory, sidebar, simpara, simplelist, table, task, title, titleabbrev, variablelist.
See Also
calloutlist, listitem, orderedlist, segmentedlist, simplelist, variablelist
Examples
<article xmlns='http://docbook.org/ns/docbook'>
<title>Example itemizedlist</title>
<itemizedlist mark='opencircle'>
<listitem>
<para>TeX and LaTeX
</para>
</listitem>
<listitem override='bullet'>
<para>Troff
</para>
</listitem>
<listitem>
<para>Lout
</para>
</listitem>
</itemizedlist>
</article>
TeX and LaTeX
Troff
Lout