Шаблён:Вонкавыя мэдыяфайлы/Дакумэнтацыя

Шаблён {{Вонкавыя мэдыяфайлы}} прызначаны для дадаваньня ў артыкулы Вікіпэдыі спасылак на мэдыя-матэрыялы, якія знаходзяцца ў інтэрнэце па-за Вікіпэдыяй і іншымі праектамі Фундацыі Вікімэдыя. Да ліку мэдыяфайлаў, спасылкі на якія могуць быць прыведзеныя гэтым шаблёнам, адносяцца выявы, відэафайлы і аўдыёфайлы.

Калі ў інтэрнэце існуюць файлы выяваў, відэа або аўдыёзьвесткі, і існуе неабходнасьць іх выкарыстаньня ў артыкуле, аднак з-за якіх-небудзь прычынаў яны ня могуць быць загружаныя ў лякальны разьдзел Вікіпэдыі або ў Вікісховішча, то ў гэтым выпадку варта карыстацца гэтым шаблёнам. Таксама ён можа выкарыстоўвацца для дадаваньня спасылак на тыя матэрыялы, наяўнасьць якіх патрабуецца ў атрыкуле ў максымальнай якасьці, якую ня могуць забясьпечыць правілы добрасумленнага выкарыстаньня.

Шаблён {{Вонкавыя мэдыяфайлы}} можа выкарыстоўвацца ў артыкуле неабмежаваную колькасьць разоў у любых месцах артыкула. Адзін шаблён дазваляе дадаваць спасылкі адначасова на ўсе тры тыпы мэдыязьвестак — выявы, відэа і аўдыё. У самім шаблёне існуе магчымасьць дадаць спасылку непасрэдна на мэдыяфайл, спасылку на вэб-старонку, дзе знаходзіцца гэты файл, дадаць зноскі, пазначыць тлумачэньні. Гэты шаблён скапіяваны з аналягічнага шаблёну en:Template:External media з ангельскага разьдзелу Вікіпэдыі, быў дапрацаваны і перакладзены.

Выкарыстаньне

Шаблён для капіяваньня	Варыянт з тлумачэньнямі	Спрошчаны шаблён для капіяваньня
{{Вонкавыя мэдыяфайлы | загаловак = | падзагаловак = | align = | clear = | шырыня = | выява1 = | выява2 = | выява3 = | аўдыё1 = | аўдыё2 = | аўдыё3 = | відэа1 = | відэа2 = | відэа3 = }}	{{Вонкавыя мэдыяфайлы | загаловак = загаловак шаблёну | падзагаловак = тлумачэньне да загалоўка | align = выроўніваньне шаблёну | clear = разьмяшчэньне адносна іншых шаблёнаў | шырыня = шырыня шаблёну | выява1 = першая выява | выява2 = другая выява | выява3 = трэцяя выява | аўдыё1 = першы аўдыёфайл | аўдыё2 = другі аўдыёфайл | аўдыё3 = трэці аўдыёфайл | відэа1 = першы відэафайл | відэа2 = другі відэафайл | відэа3 = трэці відэафайл }}	{{Вонкавыя мэдыяфайлы | загаловак = | падзагаловак = | шырыня = | выява1 = | аўдыё1 = | відэа1 = }}

Парамэтры шаблёну і іх значэньні

Парамэтар align

Дапушчальныя значэньні парамэтра align: «left» (па-беларуску: зьлева), «right» (па-беларуску: справа). Гэты парамэтар уплывае на разьмяшчэньне шаблёну на старонцы. Пры выкарыстаньні значэньня «left» шаблён будзе разьмешчаны каля левага краю старонкі. Пры выкарыстаньні значэньня «right» шаблён будзе разьмешчаны каля правага краю старонкі. Па змоўчаньні шаблён знаходзіцца з правага боку. Пры разьмяшчэньні некалькіх шаблёнаў запар, то з правага боку старонкі па змоўчаньні (залежыць ад парамэтра «clear») яны будуць разьмяшчацца вэртыкальна (адзін пад адным), а пры разьмяшчэньні зьлева — гарызантарльна (адзін каля іншага).

Парамэтар clear

Парамэтар clear вызначае разьмяшчэньне шаблёну адносна іншых шаблёнаў (у тым ліку пасьлядоўнае разьмяшчэньне некалькіх шаблёнаў {{Вонкавыя мэдыяфайлы}} адзін каля аднога). Дапушчальныя значэньні: «none» і «yes». Па змоўчаньні выкарыстоўваецца значэньне «yes» — шаблёны будуць разьмешчаныя адзін пад адным. Пры выкарыстаньні значэньня «none» шаблёны будуць разьмяшчацца ў шэраг, пачынаючы ад правага боку.

Парамэтры выява, аўдыё, відэа

Гэтыя парамэтры непасрэдна прызначаныя для разьмяшчэньня зьвестак. Існуе абмежаваньне на 30 файлаў аднаго тыпу ў адным шаблёне.

Прыклады

Вонкавыя выявы
	Баявы парадак грэцкіх фалянгітаў з доўгімі коп'ямі падчас Рымска-Спартанскай вайны. У грэцкіх гоплітаў позьняга часу шлемы з адкрытымі забраламі складаліся зь некалькіх частак, а не з адной, як раней. Для абароны ног часта выкарыстоўвалася скура, что дазваляла хутка рухацца.

{{Вонкавыя мэдыяфайлы
| align  = right
| выява1 = [http://www.ancientmesopotamia.net/sitebuildercontent/sitebuilderpictures/macedonianphalanx.jpg Баявы парадак грэцкіх фалянгітаў з доўгімі коп'ямі падчас Рымска-Спартанскай вайны]. У грэцкіх [[гопліт]]аў позьняга часу [[шлем]]ы з адкрытымі забраламі складаліся зь некалькіх частак, а не з адной, як раней. Для абароны ног часта выкарыстоўвалася скура, что дазваляла хутка рухацца.<ref>''Warfare in the Classical World'',p. 34f (Greek Hoplite (c.480BC)) p. 67 (Iphicrates reforms)</ref><ref>[http://www.ancientmesopotamia.net/id27.html Battle of Marathon]</ref>
}}

Вонкавыя выявы
Блякада Ленінграду
	Мапа вайсковых апэрацыяў вакол Ленінграду ў 1943 годзе. Сінім колерам пазначаныя нямецкія і фінскія войскі. Войскі СССР пазначаныя чырвоным колерам.
	Мапа зьняцьця блякады Ленінграду. Сінім колерам пазначаныя нямецкія і фінскія войскі. Войскі СССР пазначаныя чырвоным колерам.

{{Вонкавыя мэдыяфайлы
| align  = left
| загаловак  = Блякада Ленінграду
| выява1 = [http://www.ido.edu.ru/ffec/hist/images/H_4.jpg Мапа вайсковых апэрацыяў вакол Ленінграду ў 1943 годзе]. Сінім колерам пазначаныя нямецкія і фінскія войскі. Войскі СССР пазначаныя чырвоным колерам.<ref>[http://www.ido.edu.ru/ffec/hist/h8.html ОТЕЧЕСТВЕННАЯ ИСТОРИЯ. Тема 8]</ref>
| выява2 = [http://victory.tass-online.ru/data/Photos/Photo/175.JPEG Мапа зьняцьця блякады Ленінграду]. Сінім колерам пазначаныя нямецкія і фінскія войскі. Войскі СССР пазначаныя чырвоным колерам.<ref>[http://victory.tass-online.ru/?page=gallery&gcid=9 ИТАР-ТАСС :: 60 ЛЕТ ВЕЛИКОЙ ПОБЕДЕ]</ref>
}}

Вонкавыя аўдыёфайлы
Сабачы брэх
	Гук сабачага брэху, разьмешчаны тут

{{Вонкавыя мэдыяфайлы
| загаловак  = Сабачы брэх
| аўдыё1     = [http://www.wav-sounds.com/various/bark.wav Гук сабачага брэху], разьмешчаны [http://www.wav-sounds.com/various_wav_sounds.htm тут]
}}

Вонкавыя відэафайлы
	Відэа-кліп, які дэманструе працэс кармленьня марскога чарвяка, фармат відэа — QuickTime

{{Вонкавыя мэдыяфайлы
| шырыня   = 210px
| align    = left
| відэа1   = [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 Відэа-кліп, які дэманструе працэс кармленьня марскога чарвяка], фармат відэа — [[QuickTime]]<ref>[http://www.arkive.org/species/ARK/invertebrates_marine/Scrobicularia_plana/Scrobicularia_plana_00.html?movietype=qtSmall Peppery furrow shell]</ref>
}}

Вонкавыя мэдыяфайлы
Загаловак (файлы розных тыпаў)
Выявы
	Мапа вайсковых апэрацыяў вакол Ленінграду ў 1943 годзе. Сінім колерам пазначаныя нямецкія і фінскія войскі. Войскі СССР пазначаныя чырвоным колерам.
Аўдыёфайлы
	Гук сабачага брэху, разьмешчаны тут
Відэафайлы
	Відэа-кліп, які дэманструе працэс кармленьня марскога чарвяка, фармат відэа — QuickTime

{{Вонкавыя мэдыяфайлы
| загаловак    = Загаловак
| падзагаловак = файлы розных тыпаў
| align        = right
| шырыня       = 300px
| выява1       = [http://www.ido.edu.ru/ffec/hist/images/H_4.jpg Мапа вайсковых апэрацыяў вакол Ленінграду ў 1943 годзе]. Сінім колерам пазначаныя нямецкія і фінскія войскі. Войскі СССР пазначаныя чырвоным колерам.<ref>[http://www.ido.edu.ru/ffec/hist/h8.html ОТЕЧЕСТВЕННАЯ ИСТОРИЯ. Тема 8]</ref>
| аўдыё1       = [http://www.wav-sounds.com/various/bark.wav Гук сабачага брэху], разьмешчаны [http://www.wav-sounds.com/various_wav_sounds.htm тут]
| відэа1       = [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 Відэа-кліп, які дэманструе працэс кармленьня марскога чарвяка], фармат відэа — [[QuickTime]]<ref>[http://www.arkive.org/species/ARK/invertebrates_marine/Scrobicularia_plana/Scrobicularia_plana_00.html?movietype=qtSmall Peppery furrow shell]</ref>
}}

Выкарыстаньне парамэтру clear

Вонкавыя аўдыёфайлы
Сабачы брэх 1
	Гук сабачага брэху, разьмешчаны тут

Вонкавыя аўдыёфайлы
Сабачы брэх 2
	Гук сабачага брэху, разьмешчаны тут

Yes

Шаблёны будуць разьмяшчацца адзін пад адным (і пад папярэднімі шаблёнамі, калі яны былі).

{{Вонкавыя мэдыяфайлы
| загаловак  = Сабачы брэх 1
| clear      = yes
| аўдыё1     = [http://www.wav-sounds.com/various/bark.wav Гук сабачага брэху], разьмешчаны [http://www.wav-sounds.com/various_wav_sounds.htm тут]
}}
{{Вонкавыя мэдыяфайлы
| загаловак  = Сабачы брэх 2
| clear      = yes
| аўдыё1     = [http://www.wav-sounds.com/various/bark.wav Гук сабачага брэху], разьмешчаны [http://www.wav-sounds.com/various_wav_sounds.htm тут]
}}

Вонкавыя аўдыёфайлы
Сабачы брэх 1
	Гук сабачага брэху, разьмешчаны тут

Вонкавыя аўдыёфайлы
Сабачы брэх 2
	Гук сабачага брэху, разьмешчаны тут

None

Разьмяшчэньне адзін каля аднога (і каля папярэдніх шаблёнаў, калі яны былі).

{{Вонкавыя мэдыяфайлы
| загаловак  = Сабачы брэх 1
| clear      = none
| аўдыё1     = [http://www.wav-sounds.com/various/bark.wav Гук сабачага брэху], разьмешчаны [http://www.wav-sounds.com/various_wav_sounds.htm тут]
}}
{{Вонкавыя мэдыяфайлы
| загаловак  = Сабачы брэх 2
| clear      = none
| аўдыё1     = [http://www.wav-sounds.com/various/bark.wav Гук сабачага брэху], разьмешчаны [http://www.wav-sounds.com/various_wav_sounds.htm тут]
}}