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

С видео

{{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	Однострочный	необязательный
Пользовательский CSS	style	Пользовательский CSS для шаблона Пример float:none; clear:none	Содержимое (контент)	необязательный

См. также

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

Во избежание поломок страниц, использующих этот шаблон, экспериментируйте в песочнице (редактировать | разница) или своём личном пространстве.
Пожалуйста, добавляйте категории на подстраницу /doc. Подстраницы этого шаблона.