Шаблон:External media/doc

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

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

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

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

Заготовка для копирования	Вариант с пояснениями	Упрощённая заготовка для копирования
{{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 Название/описание изображения]. Данная запись является необходимым минимумом, однако ничто не ограничивает писать дальше.
• Во второй части значения параметра допустимы любые дополнительные детали и информация, которые так или иначе относятся к ссылаемому файлу.

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