<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 | overline-start | overline-end | roman | sans-serif | sc | strike | underline | underline-start | underline-end | ruby | named-content | styled-content | sub | sup)*

Description

This element may be contained in:

<abbrev>, <abbrev-journal-title>, <addr-line>, <aff>, <alternatives>, <alt-title>, <anonymous>, <article-title>, <attrib>, <award-id>, <bold>, <chapter-title>, <chem-struct>, <code>, <collab>, <comment>, <compound-kwd-part>, <compound-subject-part>, <conf-acronym>, <conf-loc>, <conf-name>, <conf-num>, <conf-sponsor>, <conf-theme>, <copyright-statement>, <corresp>, <data-title>, <def-head>, <degrees>, <disp-formula>, <edition>, <element-citation>, <email>, <etal>, <ext-link>, <fax>, <fixed-case>, <funding-source>, <funding-statement>, <given-names>, <gov>, <history>, <inline-formula>, <inline-supplementary-material>, <institution>, <issue>, <issue-part>, <issue-sponsor>, <issue-title>, <italic>, <journal-subtitle>, <journal-title>, <kwd>, <label>, <license-p>, <meta-name>, <meta-value>, <mixed-citation>, <monospace>, <named-content>, <on-behalf-of>, <overline>, <p>, <part-title>, <patent>, <phone>, <prefix>, <preformat>, <product>, <publisher-loc>, <publisher-name>, <rb>, <related-article>, <related-object>, <role>, <roman>, <sans-serif>, <sc>, <see>, <see-also>, <self-uri>, <series>, <series-text>, <series-title>, <sig>, <sig-block>, <source>, <speaker>, <std>, <std-organization>, <strike>, <string-conf>, <string-date>, <string-name>, <styled-content>, <sub>, <subject>, <subtitle>, <suffix>, <sup>, <supplement>, <support-source>, <surname>, <target>, <td>, <term>, <term-head>, <textual-form>, <th>, <title>, <trans-source>, <trans-subtitle>, <trans-title>, <underline>, <unstructured-kwd-group>, <uri>, <verse-line>, <version>, <volume>, <volume-id>, <volume-series>, <x>, <xref>

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