User:John Cummings/Template:External Structured Learning Resources/doc

When to use
If an educational resource:


 * 1) is currently available online,
 * 2) cannot be uploaded to Wikipedia due to constraints of the structure of Wikimedia's projects
 * 3) allow users to learn about the subject in a structured way
 * 4) functions of the site are not within scope of Wikimedia projects, e.g automated testing

then it may be appropriate to use External Structured Learning Resources to provide a direct link to the resources along with a description of the media.

Copyright
According to WP:ELNEVER and WP:COPYLINK, editors must never link to content that violates copyright or is otherwise illegal. If you are uncertain of the copyright status (for example, with links to YouTube), ask for help at Media copyright questions. If you're certain that the copyright status is acceptable, but others might wonder later, make it clear in the template or in the reference that you link to material from a rightful distributor (examples can be found at grindcore).

Where to use
This template is normally placed in the main body of the article, in the same place that you would normally have placed the image, audio, or video clip if it had been available on Wikimedia Commons.

When placing links in the ==External links== section, please use the normal formatting for external links, as explained at WP:External links and WP:External links, rather than this template.

How to use
Paste this into your article:

The external media template can be used multiple times in an article, and each instance can be used to link to more than one file.

Legend
Note: when adding a link to an external media source like this, it is essential that the source page be linked too with the date of retrieval, both to satisfy Wikipedia's sourcing criteria for the statement about the presented media and to ensure that the link can quickly be corrected should the source URL be changed. Reference tags can be used for this purpose. It's polite if you inform the administrator of the page you link to that you are deep linking to the content of his page, marking it as an external source, also providing a link to his complete page and that if he doesn't like it he can use a script to disable deep linking.
 * float: Valid options are "left", "right" and "center". The template defaults to displaying on the right-hand-side.
 * width: This should be a complete width measurement including units. Examples: 300px, 22em, 30%. The template defaults to 258px wide.
 * media links: Each file to be linked should specify its type and have a different number, starting from 1. For example, a template containing four images and one video would label them as image1, image2, image3, image4 and video1. The attribute has a free format, so any amount of detail may be added. The first part of the entry should be formatted as a normal external link, i.e. <tt> Image description </tt> for Image description. After that, any additional detail can be given on the same line. See the examples for details.

Examples
Just an image, taken from the War against Nabis Featured Article. This example gives full contextual information along with references.

<pre style="width:50%; overflow: auto">

Image, using descriptive text with accompanying reference:

<pre style="width:50%; overflow: auto">

Two images with rich accompanying text, floated left:

<pre style="width:50%; overflow: auto">

audio with topic text and accompanying link to the home page:

<pre style="width:50%; overflow: auto">

Single video, floated left:

<pre style="width:50%; overflow: auto">

Mixed content:

<pre style="width:50%; overflow: auto">

Category:External link templates