Template:External media/doc: Difference between revisions

Browse history interactively

← Previous edit

Content deleted Content added

VisualWikitext

Revision as of 00:32, 2 September 2016 edit David Koller (talk \| contribs) Extended confirmed users 2,203 edits →How to use ← Previous edit		Latest revision as of 21:45, 22 October 2024 edit undo Alter73 (talk \| contribs) Extended confirmed users 654 edits New YouTube logo
(45 intermediate revisions by 25 users not shown)
Line 1: {{Documentation subpage}} {{High-use}} <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[</nowiki>[[Wikipedia:Wikidata]]<nowiki>]]) --> Line 6 ⟶ 7: # is currently available online, # cannot be uploaded to Wikipedia, even under [[WP:NFCC\|~~fair~~non-free use]] rules, ''and'' # readers will expect this type of media in the article, Line 24 ⟶ 25: Paste this into your article, removing the parameters that are left blank: <syntaxhighlight lang="wikitext"> ~~<pre><nowiki>~~ {{ external media \| float = \| width = \| topic = <!--centered italic text---> \| caption = <!-- text placed left or right of headerimage ---> \| headerimage= <!--search commons please include "\|alt= text" and x-height in px "\|x20px" example [[File:YouTube 2024.svg\|alt=YouTube logo\|x20px\|left]] or ...\|right]] ---> \| title = \| image1 = \| image2 = Line 40 ⟶ 45: \| model2 = \| model3 = }}</~~nowiki></pre~~syntaxhighlight> The {{tl\|external media}} template can be used multiple times in an article, and each instance can be used to link to more than one file. Line 46 ⟶ 51: === Parameters === ; float: Valid options are "left", or "right~~" and "center~~". The template defaults to displaying on the right-hand-side. (Note: This template's documentation previously, and erroneously, listed {{para\|align}} as a valid parameter, but it was not valid. Instances of {{para\|align}}, if found, should usually be replaced with {{para\|float}}.) ; width: This should be a complete width measurement including units. Examples: <code>300px</code>, <code>22em</code>, <code>30%</code>. The template defaults to 258px wide. ; topic: Optional text field that will appear above the media links. ; title: Optional text to replace the automatically calculated title. ; headerimage: Optional image to display at the top of the template. Use full image syntax, for example <nowiki>[[File:example.png\|200px]]</nowiki>. ; caption: Optional caption text to put underneath the header image. ; 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 <code>image1</code>, <code>image2</code>, <code>image3</code>, <code>image4</code> and <code>video1</code>. 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. <{{code~~><nowiki>~~\|[http://example.com/image.jpg Image description]~~</nowiki></code>~~\|moin}} for [http://example.com/image.jpg Image description]. After that, any additional detail can be given on the same line. See the examples for details.~~<br~~ : />'''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.<br />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 [[Deep linking#Opt out\|script to disable deep linking]]. {{collapse top\|header=TemplateData}} <templatedata> { "params": { "width": { "description": "Width of the box", "example": "300px, 22em, 30%", "default": "258px" }, "float": { "type": "string", "suggestedvalues": [ "left", "right", "center" ], "description": "Alignment of the box on the page", "suggested": true, "default": "right" }, "title": { "description": "Optional text to replace the automatically calculated title" }, "image1": {}, "audio1": {}, "video1": {}, "model1": {}, "image2": {}, "model2": {}, "topic": { "description": "Optional text field that will appear above the media links" }, "headerimage": { "description": "Optional image to display at the top of the template. Use full image syntax, for example [[File:example.png\|200px]].", "type": "unbalanced-wikitext" }, "caption": { "description": "Optional caption text to put underneath the header image" }, "image3": {}, "image4": {}, "image5": {}, "image6": {}, "image7": {}, "image8": {}, "image9": {}, "image10": {}, "image11": {}, "image12": {}, "image13": {}, "image14": {}, "image15": {}, "image16": {}, "image17": {}, "image18": {}, "image19": {}, "image20": {}, "audio2": {}, "audio3": {}, "audio4": {}, "audio5": {}, "audio6": {}, "audio7": {}, "audio8": {}, "audio9": {}, "audio10": {}, "audio11": {}, "audio12": {}, "audio13": {}, "audio14": {}, "audio15": {}, "audio16": {}, "audio17": {}, "audio18": {}, "audio19": {}, "audio20": {}, "video2": {}, "video3": {}, "video4": {}, "video5": {}, "video6": {}, "video7": {}, "video8": {}, "video9": {}, "video10": {}, "video11": {}, "video12": {}, "video13": {}, "video14": {}, "video15": {}, "video16": {}, "video17": {}, "video18": {}, "video19": {}, "video20": {}, "model3": {}, "model4": {}, "model5": {}, "model6": {}, "model7": {}, "model8": {}, "model9": {}, "model10": {}, "model11": {}, "model12": {}, "model13": {}, "model14": {}, "model15": {}, "model16": {}, "model17": {}, "model18": {}, "model19": {}, "model20": {} }, "description": "Provides a box with a direct link to media hosted off of Wikipedia", "paramOrder": [ "title", "topic", "caption", "image1", "audio1", "video1", "model1", "width", "float", "headerimage", "image2", "model2", "image3", "image4", "image5", "image6", "image7", "image8", "image9", "image10", "image11", "image12", "image13", "image14", "image15", "image16", "image17", "image18", "image19", "image20", "audio2", "audio3", "audio4", "audio5", "audio6", "audio7", "audio8", "audio9", "audio10", "audio11", "audio12", "audio13", "audio14", "audio15", "audio16", "audio17", "audio18", "audio19", "audio20", "video2", "video3", "video4", "video5", "video6", "video7", "video8", "video9", "video10", "video11", "video12", "video13", "video14", "video15", "video16", "video17", "video18", "video19", "video20", "model3", "model4", "model5", "model6", "model7", "model8", "model9", "model10", "model11", "model12", "model13", "model14", "model15", "model16", "model17", "model18", "model19", "model20" ] } </templatedata> {{collapse bottom}} == Examples == ==== Just an image ==== ~~Just an image, taken from the [[War against Nabis]] Featured Article. This example gives full contextual information along with references.~~ Image taken from the [[War against Nabis]] Featured Article. This example gives full contextual information along with references. {{external media \| float = right \| image1 = [https://web.archive.org/web/20120211124946id_/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\|archiveurl = https://web.archive.org/web/20060224052909/http://www.ancientmesopotamia.net/id27.html \|archivedate = February 24, 2006\|url-status=dead}}</ref>) }} <~~source~~syntaxhighlight lang="~~moin~~wikitext" highlight="4" style="width:50%; overflow: auto"> {{external media \| float = right \| width = 258px \| image1 = [https://web.archive.org/web/20120211124946id_/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\|archiveurl = https://web.archive.org/web/20060224052909/http://www.ancientmesopotamia.net/id27.html \|archivedate = February 24, 2006\|url-status=dead}}</ref>) }} </syntaxhighlight> ~~</source>~~ {{-clear}} ==== Image, using descriptive text with accompanying reference: ==== {{external media Line 78 ⟶ 292: }} <~~pre~~syntaxhighlight lang="wikitext" highlight="4" style="width:50%; overflow: auto"~~><nowiki~~> {{external media \| float = right Line 84 ⟶ 298: \| 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> }} </syntaxhighlight> ~~</nowiki></pre>~~ {{-clear}} ==== Two images with rich accompanying text, floated left: ==== {{external media \| float = left \| headerimage= [[File:Internet Archive logo and wordmark.svg\|85px\|right]] \| caption = via [https://archive.org The Internet Archive] \| topic = The Siege of Leningrad \| image1 = [https://web.archive.org/web/20090226113208/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 \|archiveurl=https://web.archive.org/web/20041223033320/http://ido.edu.ru/ffec/hist/h8.html \|archivedate=December 23, 2004}}</ref> \| image2 = [https://web.archive.org/web/20090226113208/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 \|script-title=ru:ИТАР-ТАСС :: 60 ЛЕТ ВЕЛИКОЙ ПОБЕДЕ :: \|publisher=Victory.tass-online.ru \|date= \|accessdate=2008-10-26\|language=ru}} {{dead link}}</ref> }} {{clear}} <~~pre~~syntaxhighlight lang="wikitext" highlight="2,6,7" style="width:5095%; overflow: auto"~~><nowiki~~> {{external media \| float = left \| headerimage= [[File:Internet Archive logo and wordmark.svg\|85px\|right]] \| caption = via [https://archive.org The Internet Archive] \| topic = The Siege of Leningrad \| image1 = [https://web.archive.org/web/20090226113208/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 \|archiveurl=https://web.archive.org/web/20041223033320/http://ido.edu.ru/ffec/hist/h8.html \|archivedate=December 23, 2004}}</ref> \| image2 = [https://web.archive.org/web/20090226113208/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 \|script-title=ru:ИТАР-ТАСС :: 60 ЛЕТ ВЕЛИКОЙ ПОБЕДЕ :: \|publisher=Victory.tass-online.ru \|date= \|accessdate=2008-10-26\|language=ru}} {{dead link}}</ref> }} </syntaxhighlight> ~~</nowiki></pre>~~ ==== Audio with topic text and accompanying link to the home page: ==== {{external media \| topic = Dog Bark \| audio1 = [https://web.archive.org/web/20101130033309/http://www.wav-sounds.com/various/bark.wav the sound of a dog barking], from [https://web.archive.org/web/20100723141525/http://www.wav-sounds.com/various_wav_sounds.htm Wav-Sounds.com], ''retrieved 13.09.2009'' }} <~~source~~syntaxhighlight lang="~~moin~~wikitext" style="width:50%; overflow: auto"> {{external media \| topic = Dog Bark \| audio1 = [https://web.archive.org/web/20101130033309/http://www.wav-sounds.com/various/bark.wav the sound of a dog barking], from [https://web.archive.org/web/20100723141525/http://www.wav-sounds.com/various_wav_sounds.htm Wav-Sounds.com], ''retrieved 13.09.2009'' }} </syntaxhighlight> ~~</source>~~ {{-clear}} ==== Single video, floated left: ==== {{external media Line 128 ⟶ 346: }} <~~pre~~syntaxhighlight lang="wikitext" highlight="3,4" style="width:50%; overflow: auto"~~><nowiki~~> {{external media \| width = 210px Line 134 ⟶ 352: \| 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> }} </syntaxhighlight> ~~</nowiki></pre>~~ {{-clear}} ~~Two CNN videos from YouTube, floated right:~~ ==== Two CNN videos from YouTube, floated right: ==== {{external media \| float = right \| caption = Two YouTube videos ~~\| video1 = [https://www.youtube.com/watch?v=WBgwuFM92i4 CNN's exclusive Obama interview], YouTube video~~ \| headerimage= [[File:YouTube 2024.svg\|alt=YouTube logo\|x20px\|left]] ~~\| video2 = [https://www.youtube.com/watch?v=-EGLzcQj9RY Pres. Obama makes first visit to Kenya as president], YouTube video~~ \| video1 = [https://www.youtube.com/watch?v=WBgwuFM92i4 CNN's exclusive Obama interview] \| video2 = [https://www.youtube.com/watch?v=-EGLzcQj9RY Pres. Obama makes first visit to Kenya as president] }} {{clear}} <~~pre~~syntaxhighlight lang="wikitext" highlight="2" style="~~width:50~~width95%; overflow: auto"~~><nowiki~~> {{external media \| float = right \| caption = Two YouTube videos <!-- text placed left or right of headerimage ---> ~~\| video1 = [https://www.youtube.com/watch?v=WBgwuFM92i4 CNN's exclusive Obama interview], YouTube video~~ \| headerimage= [[File:YouTube 2024.svg\|alt=YouTube logo\|x20px\|left]] ~~\| video2 = [https://www.youtube.com/watch?v=-EGLzcQj9RY Pres. Obama makes first visit to Kenya as president], YouTube video~~ \| video1 = [https://www.youtube.com/watch?v=WBgwuFM92i4 CNN's exclusive Obama interview] \| video2 = [https://www.youtube.com/watch?v=-EGLzcQj9RY Pres. Obama makes first visit to Kenya as president] }} </syntaxhighlight> ~~</nowiki></pre>~~ {{-clear}} ==== Mixed content: ==== {{external media \| width = 300px \| float = right \| image1 = [https://web.archive.org/web/20110719022448/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 = [https://web.archive.org/web/20101130033309/http://www.wav-sounds.com/various/bark.wav the sound of a dog barking], from [https://web.archive.org/web/20100723141525/http://www.wav-sounds.com/various_wav_sounds.htm ~~here~~Wav-Sounds.com], ''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> \| model1 = [https://sketchfab.com/models/bb0b6ee82c7b477db4b01a14bd793409 3D model of Hoa Hakananai'a moai statue], linked from Sketchfab.<ref>https://sketchfab.com/models/bb0b6ee82c7b477db4b01a14bd793409</ref> }} <~~source~~syntaxhighlight lang="~~moin~~wikitext" style="width:50%; overflow: auto"> {{external media \| float = right Line 174 ⟶ 395: \| model1 = [https://sketchfab.com/models/bb0b6ee82c7b477db4b01a14bd793409 3D model of Hoa Hakananai'a moai statue], linked from Sketchfab.<ref>https://sketchfab.com/models/bb0b6ee82c7b477db4b01a14bd793409</ref> }} </syntaxhighlight> }} ~~</source>~~ <div style="display: none"><references /></div> ==Tracking categories== ~~<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox\|\|~~ * {{clc\|Pages using external media with unknown parameters}} <includeonly>{{Sandbox other\|\| <!-- Categories below this line, please; interwikis at Wikidata --> [[Category:External link templates]]