Шаблон:Listen

Этот шаблон реализован на основе Lua с использованием модуля Listen.

В этом шаблоне установлена проверка на неизвестные параметры, добавляющая страницы в категорию «Страницы с неизвестными параметрами шаблона Listen».

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

{{Listen
| filename    =
| title       =
| description =
| pos         =
}}

{{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) то шаблон располагается посередине текста как обычный абзац:

Гимн России как часть текста

Гимн России

---

Помощь по воспроизведению файла

Инаугурационная речь Барака Обамы (21:21)

Первая инаугурационная речь Барака Обамы, 20 января 2009
(Продолжительность: 21 минута, 21 секунда)

{{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
| род деятельности = Аккордеонист
| разное =
  {{Listen
  | filename = Accordion chords-01.ogg
  | title    = Аккорды для аккордеона
  | embed    = yes
  }}
}}

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

Аккорды для аккордеона

Аккорды, исполняемые на аккордеоне

---

Moonlight Sonata

Соната до-диез минор Бетховена.

---

Вальс № 15

Из Шестнадцати вальсов, соч. 39 Брамса.

---

Помощь по воспроизведению файлов

{{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 [[Брамс, Иоганнес|Брамса]].
}}

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