index — An index to a book or part of a book
index ::=
((((title
? &
titleabbrev
? & subtitle
?),
info
? db.titleforbidden.info) |
info
? db.info), (annotation
|
bridgehead
| remark
|
revhistory
| Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)*,
(indexdiv
* | indexentry
* |
segmentedlist
))
Common attributes and common linking attributes.
Additional attributes:
label
status
type
An index
contains the formatted index of a
document.
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.
Common attributes and common linking attributes.
Specifies an identifying string for presentation purposes
Identifies the editorial or publication status of the element on which it occurs
Specifies the target index for this term
An index
with a title
and
indexdiv
s:
<index xmlns='http://docbook.org/ns/docbook'> <title>Index</title> <indexdiv><title>D</title> <indexentry> <primaryie>database (bibliographic), 253, 255</primaryie> <secondaryie>structure, 255</secondaryie> <secondaryie>tools, 259</secondaryie> </indexentry> <indexentry> <primaryie>dates (language specific), 179</primaryie> </indexentry> <indexentry> <primaryie>DC fonts, <emphasis>172</emphasis>, 177</primaryie> <secondaryie>Math fonts, 177</secondaryie> </indexentry> </indexdiv> </index>
An index without a title
or divisions:
<index xmlns='http://docbook.org/ns/docbook'> <indexentry> <primaryie>Example</primaryie> <secondaryie>Chapter</secondaryie> <seeie>Example Chapter</seeie> </indexentry> <indexentry> <primaryie>Example Chapter, 35-48</primaryie> <seealsoie>Examples</seealsoie> </indexentry> <indexentry> <primaryie>Examples, 18, 36, 72-133</primaryie> </indexentry> </index>