◇◆
<figure> Figure
Any illustrative text or image(s), to be called out and labeled as a
figure.
Usage/Remarks
Authoring Note
The @floatstyle attribute is not available in the authoring model, as it will have no effect in
web display. For backwards-compatibility and possible future use, it is retained in
the production model.
Display/Formatting Note
Typically, no @xreflabel is present. A generated label “Figure X” (where “X” is a number based on the order
of <figure> elements in the paper) will precede the title of the figure (if one exists), “Figure
1: Interface”. Any <xref> to the figure will display only the generated label as the cross-reference’s text,
“Figure 1”. Brackets or other types of punctuation to enclose the cross-reference
must be present in the narrative text.
If an @xreflabel is used (rare occurrence), its value (e.g., xreflabel="Example 1") will display as a label preceding the title (if one exists), “Example 1: Interface”.
Any cross-reference (<xref>) to the figure will display only the @xreflabel value as the text of the cross-reference, “Vegetable 1”; punctuation to enclose the
cross-reference must be present in the narrative text.
Attributes
Models and Context
May be contained in
Description
Expanded Content Model
(title?, (blockquote | equation | figure | informaltable | itemizedlist | mediaobject | note | orderedlist | para | programlisting | table | variablelist)+, caption?)
Tagged Sample
With both a title and caption
...
<section xml:id="mul4-1">
<title>Gourds</title>
<para>The native people grew a variety of large broad-leafed, ground-covering vines
which produced what they called <quote>macocqwer</quote> or gourds. (<emphasis
role="ital">See</emphasis> <xref linkend="mul-fig1"/>.) Varying in color among shades
of green, yellow, and orange, these gourds served a number of functions, not chief
of which was as a food source. There were two distinct types, soft-shelled and
hard-shelled. Of particular interest to the settlers were pumpkins; grown throughout
the summer, this gourd remained in the fields until late autumn’s frost.
Following harvest, the gourd could be stored throughout the winter and its flesh
made into stews.</para>
<figure xml:id="mul-fig1">
<title>Gourds</title>
<mediaobject>
<imageobject>
<imagedata format="jpg" fileref="19450212-2.jpg" width="50%"/>
</imageobject>
</mediaobject>
<caption>
<para>While gourds, pumpkins and squashes were new to the English, they were soon
discovered to be very useful for warding off starvation.</para>
</caption>
</figure>
<para>However, far more important was the hard-skinned gourd. The value of this gourd lay
not in its potential as a food source, but rather as a container and serving vessel. Once
dried, these gourds were cut and hollowed for use as storage containers, as well as for
bowls, ladles, cups, and other types of serving utensils. Indeed, since gourds grew in a
variety of shapes and sizes, particular gourds could be selected for their resemblance to
the items sought. For the adventurous, the durable objects could be carved and decorated
with plant dyes.</para>
</section>
...