Шаблон:External media/Документация

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

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

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

Русифицированные перенаправления: {{внешние медиафайлы}}, {{внешние файлы}}.

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

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

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

Параметр align

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

Параметр clear

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

Параметр width

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

Параметр topic

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

Параметр font-size

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

Параметр subtopic

Параметр subtopic используется для написания примечаний к оглавлению шаблона, которые относятся ко всем ссылкам в шаблоне, но которые вместе с тем достаточно массивны и/или незначительны, чтобы выносить их в оглавление. Значение параметра выводится как стандартный викитекст сразу под оглавлением шаблона. Единственным воздействием шаблона является то, что примечание заключено в круглые скобки и выводится в уменьшенном виде (в шаблоне для уменьшения размера шрифта используются теги <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 включительно внешних ссылок с описанием.

Примеры

Внешние изображения

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

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

{{External media
 |align     = right
 |image1    = [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>{{cite web |url=http://www.ancientmesopotamia.net/id27.html |title=Battle of Marathon |accessdate=2006-12-26 |format= |publisher=Ancient Mesopotamia}}</ref>
}}

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

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

{{External media
 |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 %) и сопроводительным текстом, со ссылкой на домашнюю страницу данного аудиофайла:

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

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

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

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

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

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

{{external media
 |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

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

{{External media
 |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 здесь]
}}
{{External media
 |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

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

{{External media
 |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 здесь]
}}
{{External media
 |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 здесь]
}}