<inline-media>

Inline Media Object

Description of and pointer to an external file that holds an inline media object (for example, a pronunciation file for a word or character).

Remarks

The element <inline-media> relates to the <media> element as the <inline-graphic> element relates to <inline-graphic>.
The “content” of the <inline-media> element is not the media object itself, but information concerning the object and a pointer to the object. The external file that contains the object is named by the @xlink:href attribute.

Related Elements

This Suite contains several elements that describe and point to non-XML material: <graphic>, <inline-graphic>, <media>, <inline-media>, <supplementary-material>, and <inline-supplementary-material>. The elements <graphic> and <inline-graphic> contain a pointer to a still image (such as a photograph, diagram, line drawing, etc.) that is part of the document. The elements <media> and <inline-media> contain a pointer to a non-XML, frequently binary, object (such as a movie, audio clip, dataset, or other non-XML format) that is integral to the document’s content, where  “integral” means that the media object is discussed within (and possibly displayed within) the document; the media object is part of the document.
In contrast, the elements <supplementary-material> and <inline-supplementary-material> are used to describe either XML material (such as figures, tables, and sections) or non-XML material (such as graphics, films, audio clips, datasets, or other material) that are considered to be “additional material” (non-integral) accompanying a document. Like <graphic>, <inline-graphic>, <inline-media>, and <media>, the supplementary material elements never contain the object they describe, even if it is an XML object such as a figure, although they may point to it.
The element <inline-supplementary-material> is used to mark up references to additional material, where the reference appears within the regular flow of the text and does not have a preview image or separate caption. The <supplementary-material> element is used to describe a more complicated reference, where the description of the supplementary object resembles a figure in that it can be positioned as a floating or anchored object and may take a caption.
Best Practice: Unlabeled media objects should be tagged as <media>s, not as <fig>s. A common test to determine if an object is a <fig> versus a <media> is to ask, “If there were a “List of Figures” for this article, should this object appear in that list?”

Attributes

Content Model

<!ELEMENT  inline-media (#PCDATA %inline-media-elements;)*           >

Expanded Content Model

(#PCDATA | alt-text | long-desc | email | ext-link | uri | bold | fixed-case | italic | monospace | overline | roman | sans-serif | sc | strike | underline | ruby | named-content | styled-content | sub | sup)*

Description

This element may be contained in:

Example

To provide a link to pronunciation:
...
<p>Again she called on <inline-media id="celtic-name-hafgan" 
content-type="pronunciation" mimetype="audio" mime-subtype="mp3" 
xlink:href="http://celtic.cmrs.ucla.edu/csana/pronunciation/hafgan.mp3"
vocab="CSANA Pronunciations for Celtic Texts" 
vocab-identifier="http://celtic.cmrs.ucla.edu/csana/pronunciation.html">
Hafgan</inline-media>, to see if he would ...</p>
...