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:

Starting with version 0.6, the CNXML language does not permit 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="dog_on_couch"
       alt="A dog sitting on a couch.">
	   
  <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).

Children(what's this?)

Parents(what's this?)

preformat (media must be block display), para, title, label, cite, cite-title, link, emphasis, term, sub, sup, quote (media must be block display), foreign, footnote, equation, note (media must be block display), item, code (media must be block display), figure, subfigure, caption, commentary, meaning, entry, statement, proof, problem, solution, content (media must be block display), section (media must be block display)

Using the <media> tag

Description

Note:

Example

Attributes(what's this?)

Children(what's this?)

Parents(what's this?)