Template:EmbedMedia/doc

Purpose
This is an experimental template for testing alternatives for embedding links to third party media in accordance with the values of free cultural works licensing. It is not intended for community wide adoption and as an experimental template, it can be deleted at any time. Users experimenting with this template must adhere to all the requirements for free file formats specified below, and the template is used at your own risk in the event that it is discontinued after the experimental testing is completed.

The idea here is always to serve free format files when embedding and guide users of software that does not support free file formats to free software for viewing, converting, editing, etc.

All media files are stored on Wikimedia Commons or on WikiEducator. A download link to an alternative format may be supplied.

Usage
NB This is a test template. It seems to work. Use it if you agree with the implicit value system: those who respect freedom are not second-class citizens of the WikiEducator community. It might change (see suggestions for improvement below).

See also:


 * Tests.
 * WikiEducator and Media

Syntax
The following syntax is used for the template:

 

Align
Specify left or right alignment of the video.

Width
Specify the width of the video in pixels without the suffix "px" e.g. "400". A default width of 320 is used if no width is specified.

Height
Specify the height of the video in pixels without the suffix "px" e.g. "400". A default width of 240 is used if no height is specified.

Source
Here you should specify name of the source file on Wikimedia Commons.

The source file must first be uploaded in open file format to Wikimedia Commons. This ensures that all users will be able to view the video because WE includes an extension which enables anyone to view OGG media files (e.g. Theora, Vorbis, ...).

ogvurl
An optional parameter to include a download link (external to WikiEducator and Wikimedia Commons) to the media file.

webmurl
An optional parameter to include a download link (external to WikiEducator and Wikimedia Commons) to the media file in webm format. This one should not be required with html5.

movurl
An optional parameter to include a download link (external to WikiEducator and Wikimedia Commons) to the media file in the non-free quicktime .mov format to accommodate those whose freedom is restricted by their institutions etc.

flvurl
An optional parameter to include a download link (external to WikiEducator and Wikimedia Commons) to the media file in the non-free x-shockwave-flash .flv format to accommodate those whose freedom is restricted by their institutions etc.

mp4url
An optional parameter to include a download link (external to WikiEducator and Wikimedia Commons) to the media file in the non-free mpeg4 .mp4 format to accommodate those whose freedom is restricted by their institutions etc.

Author
Specify the name of the copyright holder of the video

License
The license must be specified and is determined by the original copyright holder. Only use videos with a CC-BY, or CC-BY-SA license, or those released to the public domain. If it is your own work, you must specify the correct license using the tags provided by Wikimedia Commons when uploading the file. So far, the template only accepts:


 * CC-BY (case sensitive)
 * CC-BY-SA (case sensitive)
 * PD (case sensitive)

Caption
Optional caption text for video container box. Uses normal wiki text.

Example
 

This syntax above will produce:

Ideas for Improving the Template

 * Make it html5 compliant so that users may include multiple links to the video in different formats.
 * Partially done.