Халыып:Тас медиа-билэлэр/Документация

Шаблон {{Тас медиа-билэлэр}} (ааҥл. external media) создан для создания в статьях Википедии ссылок на медиа-материалы, находящиеся в Интернете вне Википедии и других проектов Фонда Викимедиа. К медиа-материалам, которые «обрабатывает» данный шаблон, относятся изображения (ааҥл. image), видеофайлы (video) и аудиофайлы (audio).

Если в Интернете существуют файлы изображений, видео или аудиоданные, и их нужно использовать в статье, однако по каким-либо причинам они не подходят для загрузки в локальный раздел Википедии или на ru:Викисклад, то в этом случае сто́ит использовать данный шаблон. Также он может использоваться для проставления ссылок на те материалы, которые в статье нужны в максимальном качестве, которое не могут обеспечить текущие правила добросовестного использования.

Шаблон {{Тас медиа-билэлэр}} может использоваться в статье сколько угодно раз в любых местах статьи. Один шаблон позволяет устанавливать ссылки одновременно на все три типа поддерживаемых медиа-данных — изображения, видео и аудио. В самом шаблоне возможно вписать прямую ссылку на медиа-файл, ссылку на веб-страницу, на которой находится данный файл, проставить сноски, написать пояснения. На данный шаблон ведёт перенаправление {{Тас медиа-билэлэр}}, которое создано для совместимости. Данный шаблон был скопирован с аналогичного шаблона в английской Википедии и впоследствии был немного доработан и русифицирован.

Русифицированные перенаправления: Халыып:T1.

Использование

Заготовка для копирования	Вариант с пояснениями	Упрощённая заготовка для копирования
{{Тас медиа-билэлэр |topic = |subtopic = |font-size = |align = |clear = |width = |image1 = |image2 = |image3 = |audio1 = |audio2 = |audio3 = |video1 = |video2 = |video3 = }}	{{Тас медиа-билэлэр |topic = оглавление шаблона |subtopic = примечание к оглавлению (заключено в теги <small></small> и скобки) |font-size = размер оглавления шаблона в % |align = выравнивание шаблона |clear = расположение относительно других шаблонов |width = ширина шаблона |image1 = первое изображение |image2 = второе изображение |image3 = третье изображение |audio1 = первый аудиофайл |audio2 = второй аудиофайл |audio3 = третий аудиофайл |video1 = первый видеофайл |video2 = второй видеофайл |video3 = третий видеофайл }}	{{Тас медиа-билэлэр |topic = |subtopic = |width = |image1 = |audio1 = |video1 = }}

Параметры и значения параметров шаблона

Параметр align

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

Параметр clear

Параметр clear определяет расположение шаблона {{Тас медиа-билэлэр}} относительно других шаблонов (в том числе расположение нескольких шаблонов {{Тас медиа-билэлэр}} друг относительно друга). Допустимые значения: «none» и «yes». По умолчанию имеет значение «yes» — шаблоны будут располагаться друг под другом. При использовании значения «none» шаблоны будут располагаться в ряд, начиная справа.

Параметр width

Параметр width определяет ширину выводимого шаблона. Значение параметра может быть указано в пикселях, единицах «em» или ru:процентах. Например, «300px», «22em», «30 %». По умолчанию ширина шаблона устанавливается в 258px.

Параметр topic

Параметр topic устанавливает общее оглавление шаблона. Значение параметра и выводится в качестве оглавления.

Параметр font-size

Параметр font-size определяет размер оглавления шаблона (которое устанавливается параметром topic) в % от обычного шрифта. Нужно устанавливать значения без знака «%», например, «115». По умолчанию имеет значение 150, то есть по умолчанию размер шрифта оглавления будет равен 150% от обычного шрифта.

Параметр subtopic

Параметр subtopic используется для написания примечаний к оглавлению шаблона, которые относятся ко всем ссылкам в шаблоне, но которые вместе с тем достаточно массивны и/или незначительны, чтобы выносить их в оглавление. Значение параметра выводится как стандартный викитекст сразу под оглавлением шаблона. Единственным воздействием шаблона является то, что примечание заключено в круглые скобки и выводится в уменьшенном виде (в шаблоне для уменьшения размера шрифта используются ru:теги <small></small>).

Параметры image, audio, video

Данные параметры составляют основу шаблона и собственно они отвечают за ссылки на внешние медиа-материалы. В одном шаблоне могут использоваться ссылки как на один тип медиафайлов (например, на видео), так и на все сразу. Возможна установка нескольких ссылок на один тип медиа. При этом в шаблоне нельзя использовать «чистые» параметры image, audio, video, — их необходимо нумеровать. Например, если шаблон содержит ссылки на 4 изображения, на 2 аудиофайла и на 1 видеофайл, то параметры должны быть следующими: image1, image2, image3, image4, audio1, audio2, video1. Если в шаблоне используется больше одного типа медиа (например, видео и аудио), то при интерпретации викидвижком на страницу эти параметры будут выведены в заранее определённом порядке, то есть независимо от того, в каком порядке Вы их прописали в викикоде. Выводимый порядок такой: изображения, аудио, видео. Вы можете прописывать в шаблоне параметры «вразнобой» — сначала видео, потом аудио, потом снова видео, потом изображения и т. д. — при выводе на страницу всё будет отсортировано.

Теоретически, значения этих параметров могут быть любыми, они воспринимаются и отображаются как стандартный вики-текст. Однако существует стандартизация значений данных параметров. Значение параметра должно состоять из двух главных частей, первая из которых — обязательна.

• Первая часть является прямой ссылкой на внешний файл и форматируется как обычная внешняя ссылка: [http://example.com/image.jpg Название/описание изображения]. Данная запись является необходимым минимумом, однако ничто не ограничивает писать дальше.
• Во второй части значения параметра допустимы любые дополнительные детали и информация, которые так или иначе относятся к ссылаемому файлу. Это могут быть пояснения, описания, комментарии, сноски, другие внешние ссылки. Также во второй части значения параметра желательно поставить внутри сноски внешнюю ссылку на веб-страницу, на которой и размещено данное изображение. Наличие сноски на веб-страницу желательно по двум причинам: как авторитетный источник и для того, чтобы можно было всегда проверить и исправить прямую ссылку на файл, а также проверить соответствие самого файла по ссылке к его описанию в Википедии. Как уже было сказано выше, внешнюю ссылку желательно оформлять как сноску, заключая её внутрь тегов <ref></ref>.

Возможности шаблона позволяют в одном шаблоне внести до 30 включительно ссылок на изображения, аудио и видео, то есть до 90 включительно внешних ссылок с описанием.

Примеры

Тас ойуулар

Боевой порядок греческих фалангитов с длинными копьями во время Римско-Спартанской войны. У греческих ru:гоплитов позднего времени ru:шлемы с открытыми забралами делались из нескольких частей, а не из одной, как раньше. Для защиты ног часто применялась кожа, что позволяло быстро передвигаться. Этот боевой стиль не использовался во время Марафонской битвы; тогда копья были более короткими и удерживались одной рукой. Более длинные копья, удерживаемые двумя руками, были приняты с введением лёгких гоплитов, а потом и фалангитов. В результате из-за их длинного и тяжёлого двуручного копья гоплиты нуждались в более лёгком щите.

В шаблоне используется одно изображение, которое содержит массивный дополнительный текст с вики-форматированием и двумя сносками, в которых проставлены ссылки с использованием шаблона {{cite web}}.

{{Тас медиа-билэлэр
 |align     = right
 |image1    = [http://www.ancientmesopotamia.net/sitebuildercontent/sitebuilderpictures/macedonianphalanx.jpg Боевой порядок греческих фалангитов с длинными копьями во время Римско-Спартанской войны]. В греческих [[:ru:гоплит]]ов позднего времени [[:ru:шлем]]ы с открытыми забралами делались из нескольких частей, а не из одной, как раньше. Для защиты ног часто применялась кожа, что позволяло быстро передвигаться. Этой боевой стиль не использовался во время Марафонской битвы; тогда копья были более короткими и удерживались одной рукой. Более длинные копья, удерживаемые двумя руками, были приняты с введением легких гоплитов, а потом и фалангитов. В результате из-за их длинного и тяжелого двуручного копья гоплиты нуждались в более лёгком щите.<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= |publisher=Ancient Mesopotamia}}</ref>
}}

Тас ойуулар
Блокада Ленинграда
	Русскоязычная карта военных операций вокруг Ленинграда в 1943 году. Синим цветом помечены фашистские и финские войска. Войска СССР помечены красным.
	Карта снятия блокады Ленинграда. Синим цветом помечены фашистские и финские войска. Войска СССР помечены красным.

Два изображения с оглавлением шаблона и сопроводительным текстом, шаблон размещён слева:

{{Тас медиа-билэлэр
 |align     = left
 |topic     = Блокада Ленинграда
 |image1    = [http://www.ido.edu.ru/ffec/hist/images/H_4.jpg Русскоязычная карта военных операций вокруг Ленинграда в 1943 году]. Синим цветом помечены фашистские и финские войска. Войска СССР помечены красным.<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 Карта снятия блокады Ленинграда]. Синим цветом помечены фашистские и финские войска. Войска СССР помечены красным.<ref>{{cite web|url=http://victory.tass-online.ru/?page=gallery&gcid=9 |title=ИТАР-ТАСС :: 60 ЛЕТ ВЕЛИКОЙ ПОБЕДЕ :: |lang=ru |publisher=Victory.tass-online.ru |date= |accessdate=2008-10-26}}</ref>
}}

Тас аудио-билэлэр
Лай собаки
	Звук лая собаки, размещённый здесь

Аудио с оглавлением шаблона (размером 120%) и сопроводительным текстом, со ссылкой на домашнюю страницу данного аудиофайла:

{{Тас медиа-билэлэр
 |topic     = Лай собаки 1
 |font-size = 120
 |audio1    = [http://www.wav-sounds.com/various/bark.wav Звук лая собаки], размещённый [http://www.wav-sounds.com/various_wav_sounds.htm здесь]
}}

Тас видео-билэлэр
	Видео-клип, демонстрирующий процесс кормления морского червя, формат видео — ru:QuickTime

Одиночное видео, размещённое слева:

{{Тас медиа-билэлэр
 |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 Видео-клип, демонстрирующий процесс кормления морского червя], формат видео — [[:ru:QuickTime]]<ref>[http://www.arkive.org/species/ARK/invertebrates_marine/Scrobicularia_plana/Scrobicularia_plana_00.html?movietype=qtSmall Peppery furrow shell]</ref>
}}

Тас медиа-билэлэр
Оглавление (смешанные примеры)
Ойуулар
	Русскоязычная карта военных операций вокруг Ленинграда в 1943 году. Синим цветом помечены фашистские и финские войска. Войска СССР помечены красным.
Аудио-билэлэр
	Звук лая собаки, размещённый здесь
Видео-билэлэр
	Видео-клип, демонстрирующий процесс кормления морского червя, формат видео — ru:QuickTime

Смешанное содержимое, оглавление шаблона с примечанием:

{{Тас медиа-билэлэр
 |topic     = Оглавление
 |subtopic  = смешанные примеры
 |align     = right
 |width     = 300px
 |image1    = [http://www.ido.edu.ru/ffec/hist/images/H_4.jpg Русскоязычная карта военных операций вокруг Ленинграда в 1943 году]. Синим цветом помечены фашистские и финские войска. Войска СССР помечены красным.<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 Звук лая собаки], размещённый [http://www.wav-sounds.com/various_wav_sounds.htm здесь]
 |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 Видео-клип, демонстрирующий процесс кормления морского червя], формат видео — [[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

шаблоны будут располагаться друг под другом, обтекание предшествующих шаблонов отменяется.

{{Тас медиа-билэлэр
 |topic     = Лай собаки 1
 |font-size = 120
 |clear     = yes
 |audio1    = [http://www.wav-sounds.com/various/bark.wav Звук лая собаки], размещённый [http://www.wav-sounds.com/various_wav_sounds.htm здесь]
}}
{{Тас медиа-билэлэр
 |topic     = Лай собаки 2
 |font-size = 120
 |clear     = yes
 |audio1    = [http://www.wav-sounds.com/various/bark.wav Звук лая собаки], размещённый [http://www.wav-sounds.com/various_wav_sounds.htm здесь]
}}

Тас аудио-билэлэр
Лай собаки 1
	Звук лая собаки, размещённый здесь

Тас аудио-билэлэр
Лай собаки 2
	Звук лая собаки, размещённый здесь

None

Обтекание относительно предыдущих шаблонов.

{{Тас медиа-билэлэр
 |topic     = Лай собаки 1
 |font-size = 120
 |clear     = none
 |audio1    = [http://www.wav-sounds.com/various/bark.wav Звук лая собаки], размещённый [http://www.wav-sounds.com/various_wav_sounds.htm здесь]
}}
{{Тас медиа-билэлэр
 |topic     = Лай собаки 2
 |font-size = 120
 |clear     = none
 |audio1    = [http://www.wav-sounds.com/various/bark.wav Звук лая собаки], размещённый [http://www.wav-sounds.com/various_wav_sounds.htm здесь]
}}