Шаблон:Внешние медиафайлы/Документация



Материал из Энциклопедия нашего транспорта
< Шаблон:Внешние медиафайлы
Версия от 11:25, 28 июля 2015; Anakin (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

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

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

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

Код для вставки в статью Примечания
{{Внешние медиафайлы
  |Ширина =
  |Заголовок =
  |Подзаголовок =
  |Изображение1 =
  |Изображение2 =
  |Изображение3 =
  |Изображение4 =
  |Изображение5 =
  |Изображение6 =
  |Изображение7 =
  |Изображение8 =
  |Изображение9 =
  |Изображение10 =
  |Аудио1 =
  |Аудио2 =
  |Аудио3 =
  |Аудио4 =
  |Аудио5 =
  |Аудио6 =
  |Аудио7 =
  |Аудио8 =
  |Аудио9 =
  |Аудио10 =
  |Видео1 =
  |Видео2 =
  |Видео3 =
  |Видео4 =
  |Видео5 =
  |Видео6 =
  |Видео7 =
  |Видео8 =
  |Видео9 =
  |Видео10 =
  }}
{{Внешние медиафайлы
  |Ширина = ширина шаблона
  |Заголовок = оглавление шаблона
  |Подзаголовок = примечание к оглавлению
  |Изображение1 = 1-е изображение
  |Изображение2 = 2-е изображение
  |Изображение3 = 3-е изображение
  |Изображение4 = 4-е изображение
  |Изображение5 = 5-е изображение
  |Изображение6 = 6-е изображение
  |Изображение7 = 7-е изображение
  |Изображение8 = 8-е изображение
  |Изображение9 = 9-е изображение
  |Изображение10 = 10-е изображение
  |Аудио1 = 1-й аудиофайл
  |Аудио2 = 2-й аудиофайл
  |Аудио3 = 3-й аудиофайл
  |Аудио4 = 4-й аудиофайл
  |Аудио5 = 5-й аудиофайл
  |Аудио6 = 6-й аудиофайл
  |Аудио7 = 7-й аудиофайл
  |Аудио8 = 8-й аудиофайл
  |Аудио9 = 9-й аудиофайл
  |Аудио10 = 10-й аудиофайл
  |Видео1 = 1-й видеофайл
  |Видео2 = 2-й видеофайл
  |Видео3 = 3-й видеофайл
  |Видео4 = 4-й видеофайл
  |Видео5 = 5-й видеофайл
  |Видео6 = 6-й видеофайл
  |Видео7 = 7-й видеофайл
  |Видео8 = 8-й видеофайл
  |Видео9 = 9-й видеофайл
  |Видео10 = 10-й видеофайл
  }}

Параметры

Параметр Ширина

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

Параметр Заголовок

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

Параметр Подзаголовок

Параметр Подзаголовок используется для написания примечаний к оглавлению шаблона, которые относятся ко всем ссылкам в шаблоне, но вместе с тем достаточно массивны и/или незначительны, чтобы выносить их в оглавление. Значение параметра выводится как стандартный вики-текст сразу под оглавлением шаблона. Единственным воздействием шаблона является то, что примечание заключено в круглые скобки и выводится в уменьшенном виде.

Параметры Изображение, Аудио, Видео

Данные параметры составляют основу шаблона и именно они отвечают за ссылки на внешние медиаматериалы. В одном шаблоне могут использоваться ссылки как на один тип медиафайлов (например, на видео), так и на все сразу. Возможна установка нескольких ссылок на один тип медиа. При этом в шаблоне нельзя использовать «чистые» параметры Изображение, Аудио, Видео — их необходимо нумеровать. Например, если шаблон содержит ссылки на 4 изображения, на 2 аудиофайла и на 1 видеофайл, то параметры должны быть следующими: Изображение1, Изображение2, Изображение3, Изображение4, Аудио1, Аудио2, Видео1. Если в шаблоне используется больше одного типа медиа (например, аудио и видео), то на страницу эти параметры будут выведены в заранее определённом порядке, то есть независимо от того, в каком порядке они прописаны в вики-коде. Выводимый порядок такой: изображения, аудио, видео. Можно прописывать параметры в шаблоне «вразнобой» — сначала видео, потом аудио, потом снова видео, потом изображения и т. д. — при выводе на страницу всё будет отсортировано.

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

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

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