Шаблон:Listen

Документація шаблону[перегляд] [редагувати] [історія] [очистити кеш]

{{Listen}} дозволяє включати аудіо і відео файли у статті. Він повинен використовуватися для аудіофайлів, що відокремлені від тексту, такі як музичні відео чи звукові записи.

Просте використання

{{Listen
| файл       = 
| назва      = 
| опис       = 
| положення  = 
}}

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

Кілька файлів

Можна включити кілька файлів у статтю, додавши номер до кожного параметра.

{{Listen
| файл       = 
| назва      = 
| альт       = 
| опис       = 
| файл2      = 
| назва2     = 
| альт2      = 
| опис2      = 
| файл3      = 
| назва3     = 
| альт3      = 
| опис3      = 
}}

• файл (псевдонім: filename) (обов'язковий): назва сторінки медіафайлу, без префіксу Файл: (раніше Зображення:)
• назва (псевдонім: title) (обов'язковий): назва аудіофайлу, яка буде відображена.
• альт (псевдонім: alt): альтернативний текст для зображення, що відображається файлом. Він використовується для читачів з проблемами зору, див. '. Це потрібно для форматів файлів, що включають як і відео, так і звук. Альтернативний текст має описувати початкове статичне зображення, а не все відео чи його звук.
• опис (псевдонім: description): опис звуку, який чується

Параметри стилю

Шаблон також приймає кілька параметрів стилю, щоб контролювати свій вигляд:

• тип (псевдонім: type): може бути використаним для зміни зображення, яку відображається зліва залежно від типу вмісту аудіо, яке включається. Підтримуваними значеннями є музика, розмова, звук (стандартне значення), music, speech та sound (стандартне значення)
• заголовок (псевдонім: header): може бути використаним для додавання заголовка до контейнера.
• довідка (псевдонім: help): якщо встановити |довідка=ні (або |help=no), то приховає текст довідки, який, зазвичай, з'являється внизу контейнера. Робіть це лише якщо є інші аудіофайли на сторінці, які мають посилання на довідку; воно повинно виводитися хоча б під першим файлом у статті.
• позиція (псевдонім: pos, float): по стандарту контейнер розміщується справа. Встановивши значення left або center змінить розташування контейнера по лівому боці чи по центру відповідно.
• зображення (псевдонім: image): визначає інше зображення. Наприклад, |зображення=[[File:Example.jpg|50px]]. Ви можете встановити |зображення=відсутнє (або |image=none), щоб повністю вимкнути зображення.
• стиль (псевдонім: style): може бути використаним для передачі певних інструкцій стилю для контейнера. Встановивши значення float:none закріпить позицію контейнер, коли це зручно. Встановивши значення float:none; clear:none закріпить контейнер і дозволить коректно співіснувати з іншими контейнером, що використовує обтікання.
• грати(n) (псевдонім: play(n)): деякі медіафайли не можуть відображатися в рядку; якщо це такий випадок, то встановіть |грати=ні або |play=no), щоб запобігти відображенню поламаних рядкових посилань.
• простий (псевдонім: plain): якщо встановити |простий=так (або |plain=yes), то більшість оформлення буде видалено (межі таблиць, зображення та посилання на довідку), щоб надати найпростішу версію. Цей дозволяє видалити розміщення та обтікання зліва/справа, щоб дозволити вручну розмістити контейнер в бажану позицію, використавши параметр |стиль= (наприклад, |стиль=float:right) та навколишню розмітку.
• вбуд (псевдонім: embed): використайте |вбуд=так (або |embed=yes), щоб видалити межі та відступи, коли використовуєте як модуль для вбудовування в іншу картку (див. приклади нижче).
• початок(n) (псевдонім: start(n)): Мітка часу, з якої файл повинен почати грати.
• довжина(n) (псевдонім: length(n)): встановлюючи |довжина(n)=приховати, приховує тривалість (г:хв:с).

Приклади

Простий

{{Listen
| файл  = Accordion chords-01.ogg
| назва = Акорди акордеона
| опис  = Акорди зіграні на акордеоні
}}

З відео

{{Listen
| зображення = [[File:Crystal Project video camera.png|50px]]
| довідка    = ні
| файл       = Barack Obama inaugural address.ogv
| альт       = Чорний чоловік в чорному пальто жестикулює та розмовляє за пульпітом, оточений телесуфлерами. Позаду нього, на фоні, близько дюжини тепло одягнутих глядачів.
| назва      = Інавгураційна промова Барака Обами
| опис       = [[Перша інавгурація Барака Обами|Перша інавгураційна промова]] Барака Обами, 20 січня 2009<br />(Тривалість: 21 хвилина, 21 секунда)
}}

Із заголовком

{{Listen
| заголовок = Запис цієї фрази:
| тип       = розмова
| файл      = Frase de Neil Armstrong.ogg
| назва     = «One small step for a man...»
| опис      = Перші слова сказані на [[Місяць (супутник)|Місяці]].
}}

Вбудовування

Доктор Акордеона
Народився
Помер
Поховання
Діяльність	Гравець акордеона
Науковий ступінь
Сайт

{{Особа
| ім'я       = Доктор Акордеона
| діяльність = Гравець акордеона
| значення1  =
{{Listen
| файл  = Accordion chords-01.ogg
| назва = Акорди акордеона
| вбуд  = так
}}
}}

Простий

{{Listen | файл = Accordion chords-01.ogg | назва = Акорди акордеона | простий = так | стиль = float:left }}

Кілька файлів

{{Listen
| тип    = музика
| файл   = Accordion chords-01.ogg
| назва  = Акорди акордеона
| опис   = Акорди зіграні на акордеоні
| файл2  = Moonlight.ogg
| назва2 = «Місячна соната»
| опис2  = [[Соната для фортепіано № 14 (Бетховен)|Соната в До-дієз мінор]] [[Людвіг ван Бетховен|Бетховена]]
| файл3  = Brahms-waltz15.ogg
| назва3 = Вальс №15
| опис3  = З [[16 вальсів, Op. 39 (Брамс)|16 вальсів, Op. 39]] [[Йоганнес Брамс|Брамса]]
}}

Категорії спостереження

• К:Статті з мікроформатом hAudio (950)
• К:Статті з пустим шаблоном Listen (43)
• К:Статті з параметром plain шаблону Listen (38)

Дані шаблону

Це документація TemplateData для шаблону Listen, яка використовується Візуальним редактором та іншими інструментами.

Дозволяє включати аудіо і відео файли у статті.

Параметри шаблону[Редагувати дані шаблону]

Цей шаблон має нестандартне форматування.

Параметр		Опис	Тип	Статус
Заголовок	заголовок header	Текст або інший вміст, що розміщується вгорі над всіма файлами в шаблоні (але в межах шаблону). Дозволяє розмітку.	Вміст	необов'язковий
Іконка музики чи розмови	тип type	Введіть тут «музика» чи «розмова», щоб змінити іконку шаблону на динамік з музичними нотами чи мікрофоном. Пропоновані значення звук музика розмова sound music speech За замовчуванням sound Приклад музика	Короткий текст	необов'язковий
Власна іконка	зображення image	Власне зображення, щоб замінити іконку динаміка. Альтернативно, тут можна вказати «відсутнє» або «none», щоб повністю приховати іконку. Приклад [[File:Example.jpg|50px]], none	Файл	необов'язковий
Назва файлу	файл filename	Назва файлу. Файл2, файл3 тощо можна використовувати для наступних файлів.	Файл	обов'язковий
Назва	назва title	Назва для файлу, яка буде відображена. Назва2, назва3 тощо можна використовувати для наступних файлів.	Рядок	обов'язковий
Опис	опис description	Опис файла. Опис2, опис3 тощо можна використовувати для наступних файлів.	Рядок	пропонований
Альтернативний текст	альт alt	Альтернативний текст для файла. Альт2, альт3 тощо можна використовувати для наступних файлів. альтернативний текст для зображення, що відображається файлом. Він використовується для читачів з проблемами зору. Це потрібно для форматів файлів, що включають як і відео, так і звук. Альтернативний текст має описувати початкове статичне зображення, а не все відео чи його звук.	Невідомо	необов'язковий
Час початку	початок start	Мітка часу, з якої файл повинен почати грати (початок2, початок3 тощо можна використовувати для наступних файлів) Приклад 0:20	Короткий текст	необов'язковий
Приховати тривалість?	довжина length	Введіть тут «приховати», щоб приховати тривалість першого файлу (довжина2, довжина3 тощо можна використовувати для наступних файлів). Приклад приховати	Короткий текст	необов'язковий
Приховати програвач?	грати play	Введіть тут «ні», щоб приховати програвач для першого файлу (грати2, грати3 тощо можна використовувати для наступних файлів). Використовується для деяких медіафайлів, що не можуть відображатися в рядку, щоб запобігти відображенню поламаних рядкових посилань. Приклад ні	Короткий текст	необов'язковий
Приховати текст довідки?	довідка help	Ввведіть тут «ні», щоб приховати текст «Проблеми з програванням файлу? Див. довідку.» внизу шаблону. Не повинно використовуватися при першому виклику шаблону; необов'язково використовувати при наступних викликах. Приклад ні	Короткий текст	необов'язковий
Положення	положення pos float	Введіть тут «left» або «center», щоб змінити стандартне положення шаблона справа. Пропоновані значення left center right За замовчуванням right Приклад left	Короткий текст	необов'язковий
Простий стиль?	простий plain	Введіть тут «так», щоб видалити більшість оформлення (межі таблиць, зображення та посилання на довідку) та обтікання/розміщення шаблону, щоб надати найпростішу версію, дозволивши користувачу використати власні значення для параметра CSS («стиль»), щоб надати бажане оформлення і розміщення шаблону. Приклад так	Короткий текст	необов'язковий
Оптимізувати для вбудовування?	вбуд embed	Введіть тут будь-який текст, щоб видалити ліву, праву і нижню межу, тло, іконку, текст довідки та відступи шаблону для використання в картці. Приклад т	Короткий текст	необов'язковий
Власний CSS	стиль style	Власний CSS для шаблону Приклад float:none; clear:none	Вміст	необов'язковий