◇◆
<mediaobject> Media Object
A displayed media object; for Balisage, only still images are permitted.
Usage/Remarks
While any <mediaobject> may have its own caption,
it is more common to caption an entire <figure>
(containing one or more <mediaobject>).
Accessibility Note
While not required, a media object may include one or more textual descriptions for
accessibility purposes; one description might be a short phrase, while another might
be a longer, more complex description. Neither should be considered a replacement
for any caption. See <alt> and <textobject> for more details on using accessibility elements.
Models and Context
May be contained in
Description
The following, in order:
- <alt> Alt (For Accessibility Use), zero or one
- <imageobject> Image Object, one or more
- <textobject> Text Object (For Accessibility Use), zero or one
- <caption> Caption, zero or one
Expanded Content Model
(alt?, imageobject+, textobject?, caption?)
Tagged Sample
Graphic wrapper used for “block” elements
...
<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>
...