DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

ItemizedList

Name

ItemizedList -- A list in which each entry is marked with a bullet or other dingbat

Synopsis

Content Model

ItemizedList ::=
(ListItem+)

Attributes

Common attributes

Name	Type	Default
Spacing	Enumeration: Compact Normal	None
Mark	CDATA	None

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities

%admon.mix;	%bookcomponent.content;	%component.mix;
%divcomponent.mix;	%example.mix;	%footnote.mix;
%glossdef.mix;	%highlights.mix;	%indexdivcomponent.mix;
%legalnotice.mix;	%list.class;	%para.mix;
%qandaset.mix;	%refcomponent.mix;	%sidebar.mix;
%tabentry.mix;	%tbl.entry.mdl;	%textobject.mix;

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.

Parents

These elements contain ItemizedList: Answer, Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caption, Caution, Chapter, Colophon, Dedication, entry, Example, Footnote, Glossary, GlossDef, GlossDiv, Highlights, Important, Index, IndexDiv, InformalExample, LegalNotice, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, Section, SetIndex, Sidebar, SimpleSect, Step, TextObject, Tip, Warning.

Children

The following elements occur in ItemizedList: ListItem.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

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.

See Also

CalloutList, ListItem, OrderedList, SegmentedList, SimpleList, VariableList

Examples

<!DOCTYPE itemizedlist PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<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.

---

Prev	Home	Next
IssueNum	Up	ITermSet

Back to: DocBook: The Definitive Guide