media element, use the
for attribute to specify when that object should be displayed.Media subtypes
Within each
<media> element, at least one media subtype is required. The following sections describe how to create the various possible subtype elements.
Images
Some of the image file types and their corresponding MIME types used in Connexions modules are:
- mime-type="application/postscript"
- mime-type="image/png"
- mime-type="image/jpeg"
- mime-type="image/gif"
Embedding images
To embed images in your module, insert CNXML entries similar to the
following example into the "index.cnxml" file for your module:
<figure id="figure-01"><title>Example Figure</title><media id="figureexample" alt="an envelope with a blue page"><image mime-type="image/png" src="Xenveope-blue-on-blue.png"/></media><caption>A graphic image displayed as a figure.</caption></figure>
The
src attribute in the image tag gives the location
or source of the image that you want to appear in the module. Afterloading the image file into the 'Files' tab on your module, simply
provide the full file name (e.g. "
envelope-taller.png ") to specify
which image should be used.
The
actual display for the previous
CNXML example is:
Example figure
Adjusting the size of the image
You can use optional size attributes to control the size of the image displayed in both online and print versions of the content. There are a few things to keep in mind when specifying image sizes in CNXML:
- Images that are displayed larger than their original size will look fuzzy or grainy.
- Resizing an image online relies on the web browser to determine how to redraw the image. This can sometimes lead to unpredictable and undesirable results that vary from browser to browser.Whenever possible, resize the image to the desired dimensions before loading the file into Connexions to avoid this problem.
- It is not necessary to specify both the height and width of an image. If you supply only one of these, the other value will be calculated to preserve the same height-width ratio as theoriginal image. You only need to supply both when you wish to change the shape of the image.
- You can choose to resize an image for online viewing, printing, or both by supplying the corresponding attributes as described below. Sizes specified for one version have no effecton the other. If you do not supply sizing information, the image will be displayed in its original size by default.
Adjusting the size of an online image
You can adjust the size of the image in the on-line version of your document by using the
height and
width attributes.
The following code will display the image in its original, default size:
<figure id="element-439"><media id="tajmahal" alt="The Taj Mahal"><image src="TajMahal_medium.jpg" mime-type="image/jpeg"/></media><caption>The photograph of the Taj Mahal in this figure and the following figureswas taken by<link url="http://www.flickr.com/photos/babasteve/">Steve
Evans</link>. It is licensed for public use under the Creative Commons
Attribution License.</caption></figure>