Schema Documentation - Generic Document Profile
version 1.0

The caption element

On this page:

The caption element represents a short explanation or description accompanying a component of a publication. Captions most often occur in conjunction with illustrations, photographs, tables and diagrams.

The ref attribute identifies the component(s) to which the caption applies.

Usage Example

<object xml:id="mntsr" src="mnt_srmn.png"> … </object>    
<caption ref="mntsr">MOUNT SARMIENTO.</caption>

Allowed parents

address, annotation, m:annotation-xml, aside (block variant), aside (toc variant), block, body, caption, description, entry (bibliography variant), entry (glossary variant), item, d:longdesc, note (block variant), note (phrase variant), object, sel:otherwise, quote, section, d:simplifiedLanguageDescription, d:summary, td, th, d:tour and sel:when

Allowed children

This element may contain text.

This element may contain the following children: abbr, address (block variant), address (phrase variant), annoref, annotation (block variant), annotation (phrase variant), aside, block, ssml:break, caption, char, citation (block variant), citation (phrase variant), code (block variant), code (phrase variant), d, definition, description, d:description, emph (text variant), emph (phrase variant), expansion, xforms:group, hd, xforms:input, rend:linebreak, list, ln, m:math, name, note (block variant), note (phrase variant), noteref, num, object (block variant), object (text variant), object (phrase variant), p, pagebreak, ssml:phoneme (text variant), ssml:phoneme (phrase variant), ssml:prosody (text variant), ssml:prosody (phrase variant), quote (block variant), quote (phrase variant), xforms:range, ref, xforms:repeat, its:ruby, s, ssml:say-as (text variant), ssml:say-as (phrase variant), xforms:secret, sel:select (Block variant), sel:select (Phrase variant), xforms:select, xforms:select1, span (text variant), span (phrase variant), sub, ssml:sub (text variant), ssml:sub (phrase variant), sup, table, term, xforms:textarea, time, ssml:token (text variant), ssml:token (phrase variant), transition, verse and w

Content model and additional requirements

optional attributes: @about, @by, @class, @content, @continuation, @datatype, @desc, @its:dir, @its:translate, @property, @ref, @rel, @resource, @rev, @role, @sel:selid, @ssml:onlangfailure, @typeof, @xml:base, @xml:id, @xml:lang and @xml:space
a choice of
either one or more of
any of the 24 elements: address, annotation, aside, block, caption, citation, code, d:description, description, hd, list, m:math, note, object, p, pagebreak, quote, sel:select, ssml:break, table, transition, verse, xforms:group and xforms:repeat
or one or more of
a choice of
either one of the 53 elements: abbr, address, annoref, annotation, char, citation, code, d, definition, emph, emph, expansion, its:ruby, ln, m:math, name, note, noteref, num, object, object, pagebreak, quote, ref, rend:linebreak, s, sel:select, span, span, ssml:break, ssml:break, ssml:phoneme, ssml:phoneme, ssml:prosody, ssml:prosody, ssml:say-as, ssml:say-as, ssml:sub, ssml:sub, ssml:token, ssml:token, sub, sup, term, time, w, w, xforms:input, xforms:range, xforms:secret, xforms:select, xforms:select1 or xforms:textarea
or text
end of choice
end of choice
Note that in addition to restrictions presented in the content model above, use of this element must also respect the following requirements:
  • The caption element must not contain child caption elements.
  • The caption element must neither be empty nor contain only whitespace.
Such requirements take precedence over any conflicting statements in the content model or in the lists above of allowed children and parents.

Namespace

http://www.daisy.org/ns/z3998/authoring/