<media>

Media Object

Definition

An external file that holds a media object, such as an animation or a movie

The “content” of the Media Object element is not the object itself but merely information about the object. The external file that contains the object is named by the xlink:href attribute.

Remarks

Authoring and Conversion Note: Although, in theory, the position attribute of this element may be used to indicate whether this element must be anchored at its exact location within the text or whether it may float, it is usually good practice to anchor media objects. The few media files that are really floating loose in text should be anchored there, and all the media objects inside figures, tables, etc. should be anchored as well, although the outer structure (figure, boxed-text) may be allowed to float.

Authoring and Conversion Note: Internal Elements, such as <caption>, should always be used at the highest possible level; in other words, if a Media Object <media> element is inside a Figure <fig>, the <caption>, <long-desc>, etc. should be part of the Figure, not part of the Media Object. Use a <caption> element on a Media Object only when the media object is not enclosed in any other structure or when a figure contains multiple media objects, each of which must have a <caption>. Similarly, the Position attribute should not be used on a <media> that is inside a larger display container such as a Paragraph <p>.

Attributes

alternate-form-of Alternate Form of Graphic, Media Object, Etc.
alternate-form-of Alternate Form of Graphic, Media Object, Etc.
id Identifier
mime-subtype Mime Subtype
mimetype Mime Type

Related Elements

This DTD Suite contains several elements to describe non-XML material: <graphic>, <inline-graphic>, <media>, and <supplementary-material>. The elements <graphic> and <inline-graphic> are used for “still” images, i.e., photographs, diagrams, etc. The distinction between the two other elements is more subtle. The element <media> should be used for movies, audio clips, or media in other formats which is intrinsic to the document’s content, that is, the media object is discussed within the document. The element <supplementary-material> should be used for films, audio clips, or other material which enhances a document, but which is not discussed as part of the document.

Authoring and Conversion Note: Unlabeled media objects should be tagged as <media>s, not as <fig>s. A common test to determine whether an object is a Figure <fig> versus a Media Object <media> is to ask, “If there were a ‘List of Figures’ for this article, should this object appear in that list?”

Model Description

Any combination of:

Tagged Example

No sample is available at this time.
    

Module

display.ent