caption (db.caption)

Simplified DocBook: The Definitive Guide (Version 0.9.1 for Simplified DocBook 5.1)

caption (db.caption)

caption — A caption.

Synopsis

caption (db.caption) ::=

Sequence of:
- info? (db.titleforbidden.info)
- One or more of:
  - Sequence of:
    note
  - empty
  - empty
  - Sequence of:
    note
  - revhistory
  - Formal elements
    example
    figure
    table (db.cals.table)
    table (db.html.table)
  - Graphic elements
    mediaobject
  - Informal elements
    informaltable (db.cals.informaltable)
    informaltable (db.html.informaltable)
  - List elements
    itemizedlist
    orderedlist
    variablelist
  - Paragraph elements
    para
  - Publishing elements
    blockquote
    epigraph
    sidebar
  - Verbatim elements
    literallayout
    programlisting

Attributes

Common attributes and common linking attributes.

Additional Constraints

note must not occur among the children or descendants of caption
example must not occur among the children or descendants of caption
figure must not occur among the children or descendants of caption
table must not occur among the children or descendants of caption
sidebar must not occur among the children or descendants of caption

Description

A caption is an extended description of a mediaobject or figure or other formal or informal element. Unlike a textobject, which is an alternative to the other elements in the mediaobject, the caption augments the object.

Processing expectations

Formatted as a displayed block.

Parents

These elements contain caption: example, figure, informaltable (db.cals.informaltable), mediaobject, table (db.cals.table).

Children

The following elements occur in caption: blockquote, epigraph, example, figure, info (db.titleforbidden.info), informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, literallayout, mediaobject, note, orderedlist, para, programlisting, revhistory, sidebar, table (db.cals.table), table (db.html.table), variablelist.

See Also

audioobject, caption (db.html.caption), imageobject, inlinemediaobject, mediaobject, textobject, videoobject

Examples

See informalfigure for and example that uses caption.