Help on using the <media> tag

The media tag is used to insert media objects into a CNXML document. The media objects can be images, applets, movies, sounds, or any object with a valid MIME type.

Note:

CNXML 0.6 does not validate URLs that contain ampersand (&) characters (i.e., http://cnx.org/example?i=1&p=2). Check all media src URLs and replace any ampersands with the entity reference "&". More information can be found on the W3C's page.

Example

This CNXML:


<media id="foto_de_perro"
       alt="Un perro sentado en una cama">
  <image mime-type="image/jpeg"
         src="image1.jpg" />
</media>

Results in this display:

Attributes(what's this?)

alt (required): "Alt" text is used by browsers and other tools to make the content of images available to all users, including visually impaired users with screen readers. It is a text representation of the meaning of an image. Remember, "alt" text replaces an image; it does not describe it.
display (optional):
Possible values:
- block - The media will be set apart from the surrounding text.
- inline - The media will be included in the current line of text.
- none - The media will not be displayed.
longdesc (optional): The URL of a file containing a long description of the media. Not all readers will be able to see your included media in their browser, either due to blindness, low-vision, or an environment that doesn't support the media. Some media are too complex to describe fully in a few words using the "alt" attribute, however. For media like charts and graphs that are important for understanding the material, use "longdesc" to point to a Web file that contains a full explanation of the media.
id (required): A unique identifier, whose value must begin with a letter and contain only letters, numbers, hyphens, underscores, colons, and/or periods (no spaces).

Using the <media> tag

Description

Note:

Example

Attributes(what's this?)

Children(what's this?)

Parents(what's this?)