Template:External media/doc

Note: this template has recently been copied from Wikipedia ([1]). The documentation below may reference aspects of Wikipedia policy that don't apply to usage here on Wikiversity.

Overview

This template organizes a set of external URL links to media in a small box labelled "External links", with an icon by each one to indicate the type of media. It is definitely not required when writing from scratch, and can be functionally replaced by an ordinary link in square brackets. But it's cute, and maintaining compatibility with it makes it easier to bring over content from Wikipedia.

How to use

Paste this into your article:

{{ external media

| align  = 
| width  = 
| image1 = 
| image2 = ...
| image3 = ...
| audio1 = ...
| audio2 = ...
| audio3 = ...
| video1 = ...
| video2 = ...
| video3 = ...
}}

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

align

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. [http://example.com/image.jpg Image description] for Image description. After that, any additional detail can be given on the same line. See the examples for details.
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.

Examples

External images

Fighting style of Greek phalangites with long lances during the Roman-Spartan War (Note the late Greek hoplite helmets with open visors made of several parts and not from one like in earlier times. The leg protection was often leather to allow for faster movement. This fighting style was not in use during the Battle of Marathon; at that time the lances were shorter and held with one hand. Longer lances, held with both hands, were adopted with the introduction of lighter hoplites and later phalangites. As a result of their long and heavy lance which was handled with both arms they needed a lighter shield than the old hoplites.

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

{{ external media
| align = right
| width = 258px
| image1 = [http://www.ancientmesopotamia.net/sitebuildercontent/sitebuilderpictures/macedonianphalanx.jpg Fighting style of Greek phalangites with long lances during the Roman-Spartan War] (Note the late Greek hoplite helmets with open visors made of several parts and not from one like in earlier times. The leg protection was often leather to allow for faster movement. This fighting style was not in use during the [[Battle of Marathon]]; at that time the lances were shorter and held with one hand. Longer lances, held with both hands, were adopted with the introduction of lighter hoplites and later [[phalangite]]s. As a result of their long and heavy lance which was handled with both arms they needed a lighter shield than the old hoplites.<ref>''Warfare in the Classical World'',p. 34f (Greek Hoplite (c.480BC)) p. 67 (Iphicrates reforms)</ref><ref>{{cite web |url=http://www.ancientmesopotamia.net/id27.html |title=Battle of Marathon |accessdate=2006-12-26 |format= |work=Ancient Mesopotamia}}</ref>
}}

External images
	Metal vambrace with integrated elbow and upper arm protection (reenactment)

Image, using descriptive text with accompanying reference:

{{ external media
| align  = right
| width  = 300px
| image1 = [http://fcit.usf.edu/florida/photos/historic/dsmem/dsarmor/dsarmo2/photos/dsarmo232.jpg Metal vambrace with integrated elbow and upper arm protection] (reenactment)<ref>http://fcit.usf.edu/florida/photos/historic/dsmem/dsarmor/dsarmo2/dsarmo232.htm</ref>
}}

External images
The Siege of Leningrad
	Russian map of the operations around Leningrad in 1943. Blue are the German and allied Finnish troops. The Soviets are red.
	map of the advance on Leningrad and relief. Blue are the German and allied Finnish troops. The Soviets are red.

Two images with rich accompanying text, floated left:

{{ external media
| align  = left
| topic  = The Siege of Leningrad
| image1 = [http://www.ido.edu.ru/ffec/hist/images/H_4.jpg Russian map of the operations around Leningrad in 1943]. Blue are the German and allied Finnish troops. The Soviets are red.<ref>{{cite web|url=http://www.ido.edu.ru/ffec/hist/h8.html |title=ОТЕЧЕСТВЕННАЯ ИСТОРИЯ. Тема 8 |publisher=Ido.edu.ru |date= |accessdate=2008-10-26}}</ref>
| image2 = [http://victory.tass-online.ru/data/Photos/Photo/175.JPEG map of the advance on Leningrad and relief]. Blue are the German and allied Finnish troops. The Soviets are red.<ref>{{cite web|url=http://victory.tass-online.ru/?page=gallery&gcid=9 |title=ИТАР-ТАСС :: 60 ЛЕТ ВЕЛИКОЙ ПОБЕДЕ :: |language=ru |publisher=Victory.tass-online.ru |date= |accessdate=2008-10-26}}</ref>
}}

External audio
Dog Bark
	the sound of a dog barking, from here, retrieved 13.09.2009

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

{{ external media
| topic  = Dog Bark
| audio1 = [http://www.wav-sounds.com/various/bark.wav the sound of a dog barking], from [http://www.wav-sounds.com/various_wav_sounds.htm here] ''retrieved 13.09.2009''
}}

External videos
	Movie clip of siphon feeding, QuickTime format

Single video, floated left:

{{ external media
| width  = 210px
| align  = left
| video1 = [http://www.arkive.org/scripts/php/force-download.php?file=BEE7098E-088F-4BB4-B6F0-D2E190E5623C/Presentation.Streams/Presentation_QT_DOWNLOAD.mov&saveas=/data/root/Live/www.arkive.org/htdocs/species/peppery-furrow-shell/scrobicularia-plana/video-00.xml&type=mov Movie clip of siphon feeding], QuickTime format<ref>[http://www.arkive.org/species/ARK/invertebrates_marine/Scrobicularia_plana/Scrobicularia_plana_00.html?movietype=qtSmall Peppery furrow shell]</ref>
}}

External media
Images
	Russian map of the operations around Leningrad in 1943. Blue are the German and allied Finnish troops. The Soviets are red.
Audio
	the sound of a dog barking, from here, retrieved 13.09.2009
Videos
	Movie clip of siphon feeding, QuickTime format

Mixed content:

{{ external media
| align  = right
| width  = 300px
| image1 = [http://www.ido.edu.ru/ffec/hist/images/H_4.jpg Russian map of the operations around Leningrad in 1943]. Blue are the German and allied Finnish troops. The Soviets are red.<ref>{{cite web|url=http://www.ido.edu.ru/ffec/hist/h8.html |title=ОТЕЧЕСТВЕННАЯ ИСТОРИЯ. Тема 8 |publisher=Ido.edu.ru |date= |accessdate=2008-10-26}}</ref>
| audio1 = [http://www.wav-sounds.com/various/bark.wav the sound of a dog barking], from [http://www.wav-sounds.com/various_wav_sounds.htm here], ''retrieved 13.09.2009''
| video1 = [http://www.arkive.org/scripts/php/force-download.php?file=BEE7098E-088F-4BB4-B6F0-D2E190E5623C/Presentation.Streams/Presentation_QT_DOWNLOAD.mov&saveas=/data/root/Live/www.arkive.org/htdocs/species/peppery-furrow-shell/scrobicularia-plana/video-00.xml&type=mov Movie clip of siphon feeding], QuickTime format<ref>[http://www.arkive.org/species/ARK/invertebrates_marine/Scrobicularia_plana/Scrobicularia_plana_00.html?movietype=qtSmall Peppery furrow shell]</ref>
}}