Документация

{{Listen}} позволяет вставлять аудио- и видеофайлы в статьи. Его следует использовать для аудиофайлов, которые выделяются из текста, например, музыкальных клипов или звукозаписей.

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

править
  • filename (обязательный): имя страницы медиафайла, без префикса Файл:
  • title (обязательный): название аудиофайла, которое будет отображаться. Не используйте вики-ссылки в названии — они не будут работать.
  • description: описание воспроизводимых звуков
  • pos: right (стандарт), left или center

Несколько файлов

править

В статью с одним шаблоном можно вставлять дополнительные файлы, добавляя к каждому параметру номер.

{{Listen
| filename     =
| title        =
| alt          =
| description  =
| filename2    =
| title2       =
| alt2         =
| description2 =
| filename3    =
| title3       =
| alt3         =
| description3 =
}}
  • alt: текстовое описание изображения, отображаемого для файла, для читателей с ослабленным зрением или пользователей читалок; см. Википедия:Доступность#Изображения. Это необходимо для таких форматов файлов, как формат .ogv Ogg, который включает в себя видео. Альт-текст должен описывать только исходное статичное изображение, а не всё видео или его звук.

Параметры оформления

править

Шаблон принимает также несколько оформительских параметров, влияющих на его отображение:

  • type: можно использовать для изменения изображения, отображаемого слева, в зависимости от типа встраиваемого аудиоконтента. Допустимые значения: music, speach и sound (по умолчанию).
  • header: можно использовать для добавления заголовка в блок.
  • help: если установлено значение |help = no, подавляет текст справки, который обычно появляется в нижней части окна. Делайте это только в том случае, если на странице есть другие аудиофайлы, в которых есть ссылка на справку; справка должна быть предоставлена как минимум в первом файле статьи.
  • pos: по умолчанию блок размещается в правой части экрана. Если установить значение left или center, окно будет располагаться с левой стороны или по центру, соответственно.
  • image: задайте другое изображение. Например, |image = [[Файл:Example.jpg|50px]]. Вы можете задать |image = none, чтобы полностью отключить изображение.
  • style: можно использовать для передачи боксу определённых стилевых инструкций. Если установить значение float: none, бокс будет прикреплён, там удобнее. Установка значения float: none; clear: none позволит закрепленному боксу изящно сосуществовать рядом с другим плавающим боксом.
  • play(n): некоторые медиафайлы не могут отображаться в строке; в этом случае установите |play = no, чтобы предотвратить отображение неработающей ссылки в строке.
  • plain: если установить |plain = yes, удаляет большую часть визуальных элементов (границы таблицы, изображения и ссылки на справку), чтобы получить минималистичную версию. Это также удаляет левое/правое плавающее положение и позиционирование, чтобы можно было вручную позиционировать поле по желанию с помощью |style =. (например, |style = float:right) и окружающую разметку.
  • embed: используйте |embed = yes, чтобы убрать границы и подложку при использовании в качестве подшаблона, встроенного в другую карточку (см. примеры ниже).
  • start(n): временная метка, с которой должно начаться воспроизведение файла
  • length(n): установленный |length'(n) = hide скрывает продолжительность (ч: м: с).

Примеры

править

Обычный

править
{{Listen
| filename    = Accordion chords-01.ogg
| title       = Аккорды для аккордеона
| description = Аккорды, исполняемые на аккордеоне
}}

Позиция

править
right — справа (по умолчанию)

Если параметр имеет значение right (| pos = right), то шаблон располагается справа от текста. Если параметр не задан, то подразумевается right, так же как и при любом другом значении.

left — слева

Если параметр имеет значение left (| pos = left), то шаблон располагается слева от текста.

center — по центру

Если параметр имеет значение center (| pos = center) то шаблон располагается посередине текста как обычный абзац:

С видео

править
{{Listen
| image       = [[Файл:Crystal Project video camera.png|50px]]
| help        = no
| filename    = Barack Obama inaugural address.ogv
| alt         = Чернокожий мужчина в чёрном пальто жестикулирует и говорит за пюпитром, окруженным телесуфлерами. Позади него, на заднем плане, стоят около дюжины тепло одетых зрителей.
| title       = Инаугурационная речь Барака Обамы
| description = [[Инаугурация Барака Обамы (2009)|Первая инаугурационная речь]] Барака Обамы, 20 января 2009<br>(Продолжительность: 21 минута, 21 секунда)
}}

С заголовком

править
{{Listen
| header      = Запись этой фразы:
| type        = speech
| filename    = Frase de Neil Armstrong.ogg
| title       = «Один маленький шаг для человека…»
| description = Первые слова, произнесенные на [[Луна|Луне]].
}}

Встраивание

править
Dr. Accordion
Род деятельности Аккордеонист
Разное
{{Персона
| имя = Dr. Accordion
| род деятельности = Аккордеонист
| разное =
  {{Listen
  | filename = Accordion chords-01.ogg
  | title    = Аккорды для аккордеона
  | embed    = yes
  }}
}}

Упрощённое оформление

править
{{Listen
| filename = Accordion chords-01.ogg
| title    = Аккорды для аккордеона
| plain    = yes
| style    = float:left
}}

Несколько файлов

править
{{Listen
| type         = music
| filename     = Accordion chords-01.ogg
| title        = Аккорды для аккордеона
| description  = Аккорды, исполняемые на аккордеоне
| filename2    = Moonlight.ogg
| title2       = ''Moonlight Sonata''
| description2 = [[Соната для фортепиано № 14 (Бетховен)|Соната до-диез минор]] [[Людвиг ван Бетховен|Бетховена]].
| filename3    = Brahms-waltz15.ogg
| title3       = Вальс № 15
| description3 = Из Шестнадцати вальсов, соч. 39 [[Брамс, Иоганнес|Брамса]].
}}

TemplateData

править
Здесь приведена документация в формате TemplateData для данного шаблона, которая используется в TemplateWizard, визуальном редакторе и прочих инструментах. Смотрите ежемесячный отчет об использовании параметров этого шаблона в статьях.

Позволяет встраивать аудио- и видеофайлы в статьи.

Параметры шаблона[Править данные шаблона]

Шаблон использует собственное форматирование параметров.

ПараметрОписаниеТипСтатус
Заголовокheader

Текст или другое содержимое, которое должно располагаться над всеми файлами шаблона (но в пределах границ шаблона). Разрешает разметку.

Содержимое (контент)необязательный
Тип (значок музыки или речи)type

Введите здесь "music" или "speech", чтобы изменить значок шаблона на динамик с нотами или микрофон.

Предлагаемые значения
sound music speech
По умолчанию
sound
Пример
music
Однострочныйнеобязательный
Пользовательское изображениеimage

Пользовательское изображение для замены значка динамика в шаблоне. В качестве альтернативы введите здесь "none", чтобы полностью скрыть значок.

Пример
[[Файл:Example.jpg|50px]], none
Имя файланеобязательный
Имя файлаfilename Имя_файла

Имя файла. Filename2, filename3 и т. д. могут использоваться для последующих файлов.

Имя файлаобязательный
Названиеtitle Название

Заголовок, отображаемый для данного файла. Title2, title3 и т. д. можно использовать для последующих файлов.

Строковый (без форматирования)обязательный
Описаниеdescription Описание

Описание файла. Description2, description3 и т. д. могут использоваться для последующих файлов.

Строковый (без форматирования)предложенный
Время начала воспроизведенияstart

Временная метка начала воспроизведения первого файла (для последующих файлов можно использовать метки start2, start3 и т. д.)

Пример
0:20
Однострочныйнеобязательный
Скрыть длительность?length

Введите "hide", чтобы скрыть длительность первого файла (для последующих файлов можно использовать length2, length3 и т. д.).

Предлагаемые значения
hide
Пример
hide
Однострочныйнеобязательный
Скрыть плеер?play

Введите "no", чтобы скрыть проигрыватель для первого файла (для последующих файлов можно использовать play2, play3 и т. д.). Используется для некоторых медиафайлов, которые не могут быть отображены в строке, чтобы предотвратить отображение неработающей ссылки в строке.

Предлагаемые значения
no
Пример
no
Однострочныйнеобязательный
Скрыть текст помощи?help

Введите "no", чтобы скрыть текст "Помощь по воспроизведению файла" в нижней части шаблона. Не должно выполняться в первом экземпляре шаблона; необязательно для последующих экземпляров шаблона.

Предлагаемые значения
no
Пример
no
Однострочныйнеобязательный
Позицияpos float выравнивание

Введите здесь "left" или "center", чтобы изменить положение шаблона по умолчанию на правое.

Предлагаемые значения
left center right
По умолчанию
right
Пример
left
Однострочныйнеобязательный
Простой стиль?plain простой

Введите "да", чтобы частично удалить визуальное оформление (границы, фон, иконки и текст справки) и плавающие элементы/позицию шаблона для создания минималистичной версии, позволяющей пользователю использовать пользовательский параметр CSS ("style") для стилизации и позиционирования шаблона.

Предлагаемые значения
yes
Пример
yes
Однострочныйнеобязательный
Оптимизировать для встраивания?embed

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

Предлагаемые значения
yes
Пример
yes
Однострочныйнеобязательный
Пользовательский CSSstyle

Пользовательский CSS для шаблона

Пример
float:none; clear:none
Содержимое (контент)необязательный

См. также

править
  • {{Audio}} — вариант шаблона, предназначенный для употребления в тексте, например, для примера произношения.
  • {{Образец аудио}}