DocBook 5.1: The Definitive Guide  (Version 1.5.3 for DocBook 5.1)

caption (db.caption)

caption — A caption.

Synopsis

caption (db.caption) ::= [-]

Additional Constraints

  • 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
  • equation must not occur among the children or descendants of caption
  • sidebar must not occur among the children or descendants of caption
  • task must not occur among the children or descendants of caption
  • caution must not occur among the children or descendants of caption
  • important must not occur among the children or descendants of caption
  • note must not occur among the children or descendants of caption
  • tip must not occur among the children or descendants of caption
  • warning must not occur among the children or descendants of caption
  • If this element is the root element, it must have a version attribute.

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: equation, example, figure, informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), mediaobject, table (db.cals.table).

Examples

See informalfigure for and example that uses caption.