DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

caption

caption — A caption.

Synopsis

caption ::= [x]  [+]

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
  • note 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.

Children

The following elements occur in caption: address, anchor, bibliolist, blockquote, bridgehead, calloutlist, dialogue, drama, epigraph, equation, example, figure, formalpara, glosslist, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandaset, remark, revhistory, sidebar, simpara, simplelist, table, task, variablelist.

Examples

See informalfigure for and example that uses caption.