index
index — An index to a book or part of a book.
Synopsis
index ::=
- Sequence of:
- One of:
- Zero or more of:
annotation
bridgehead
formalgroup
remark
revhistory
- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)
- List elements
- Paragraph elements
- Publishing elements
- Synopsis elements
- Technical elements
- Verbatim elements
- One of:
- Zero or more of:
- Zero or more of:
segmentedlist
Attributes
Common attributes and common linking attributes.
Additional attributes:
- label
- status
- type
Additional Constraints
- If this element is the root element, it must have a version attribute.
Description
An index
contains the formatted index of a
document.
Processing expectations
Formatted as a displayed block. An index
in a
book
frequently causes a forced page break in print
media.
In many processing systems, indexes are generated automatically or semiautomatically and never appear instantiated as DocBook markup.
Often an empty index
is used to indicate where the
automatically generated index should be rendered.
Authors can choose to have several types of indexes: for
example, function, command, and concept indexes. This can be achieved
in DocBook with the type
attribute. All
of the indexterm
s with a particular type
will be collected together in the
index
with the same type
.
All indexterm
s, irrespective of their type
, appear in an index
that has
no type
attribute.
Attributes
Common attributes and common linking attributes.
- any attribute
Any attribute in any other explicit namespace
- label
Specifies an identifying string for presentation purposes
- status
Identifies the editorial or publication status of the element on which it occurs
- type
Specifies the target index for this term
Parents
These elements contain index
: appendix
, article
, book
, chapter
, part
, preface
, sect1
, sect2
, sect3
, sect4
, sect5
, section
, topic
.
Children
The following elements occur in index
: 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
, indexdiv
, indexentry
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), info
(db.info), info
(db.titleforbidden.info), informalequation
, informalexample
, informalfigure
, informaltable
(db.cals.informaltable), informaltable
(db.html.informaltable), itemizedlist
, literallayout
, macrosynopsis
, mediaobject
, methodsynopsis
, msgset
, note
, orderedlist
, packagesynopsis
, para
, procedure
, productionset
, programlisting
, programlistingco
, qandaset
, remark
, revhistory
, screen
, screenco
, screenshot
, segmentedlist
, sidebar
, simpara
, simplelist
, subtitle
, synopsis
, table
(db.cals.table), table
(db.html.table), task
, tip
, title
, titleabbrev
, typedefsynopsis
, unionsynopsis
, variablelist
, warning
.
Examples
An index
with a title
and
indexdiv
s.
1 |<index xmlns='http://docbook.org/ns/docbook'>
|<title>Index</title>
||
<indexdiv><title>D</title>
5 |<indexentry>
|<primaryie>database (bibliographic), 253, 255</primaryie>
|<secondaryie>structure, 255</secondaryie>
|<secondaryie>tools, 259</secondaryie>
|</indexentry>
10 |<indexentry>
|<primaryie>dates (language specific), 179</primaryie>
|</indexentry>
|<indexentry>
|<primaryie>DC fonts, <emphasis>172</emphasis>, 177</primaryie>
15 |<secondaryie>Math fonts, 177</secondaryie>
|</indexentry>
|</indexdiv>
|</index>
An index without a title
or divisions.
1 |<index xmlns='http://docbook.org/ns/docbook'>
|<indexentry>
|<primaryie>Example</primaryie>
|<secondaryie>Chapter</secondaryie>
5 |<seeie>Example Chapter</seeie>
|</indexentry>
||
<indexentry>
|<primaryie>Example Chapter, 35-48</primaryie>
10 |<seealsoie>Examples</seealsoie>
|</indexentry>
||
<indexentry>
|<primaryie>Examples, 18, 36, 72-133</primaryie>
15 |</indexentry>
||
</index>