Template:SetlistBox/doc: Difference between revisions

Revision as of 00:06, 7 July 2025

Описание

SetlistBox — шаблон для отображения сет-листа музыкального концерта. Включает:

список песен,
декоративную кольцевую диаграмму,
интерактивное collapsible-меню,
imagemap с ссылками на альбом или другие статьи.

Подходит для страниц выступлений, туров или сет-листов альбомов.

Пример использования

{{SetlistBox
|song1=Friend, Please
|note1=second known time
|song2=Trapdoor
|note2=second known time
|song3=Johnny Boy
|song4=March To The Sea
|note4=(live debut)
|song5=Fall Away
|note5=second known time
|ring-color=#87B22A
|album-name=Twenty One Pilots
|album-link=Twenty One Pilots (album)
|imagemap-file=Emty.png
|imagemap-link1=Twenty One Pilots (album)
|imagemap-text1=Twenty One Pilots
|imagemap-link2=Twenty One Pilots (album)
|imagemap-text2=Twenty One Pilots
|song-count=5
}}

Параметры

Параметр	Описание	Пример
`song1` – `song5`	Названия песен	`Johnny Boy`
`note1` – `note5`	Подписи под песнями (примечания)	`live debut`
`ring-color`	Цвет кольца (в CSS-формате)	`#87B22A`
`album-name`	Название альбома в таблице	`Twenty One Pilots`
`album-link`	Ссылка на статью об альбоме	`Twenty One Pilots (album)`
`imagemap-file`	Название файла изображения для imagemap	`Emty.png`
`imagemap-link1`	Ссылка 1 в imagemap	`Twenty One Pilots (album)`
`imagemap-text1`	Текст ссылки 1 в imagemap	`Twenty One Pilots`
`imagemap-link2`	Ссылка 2 в imagemap	`Twenty One Pilots (album)`
`imagemap-text2`	Текст ссылки 2 в imagemap	`Twenty One Pilots`
`song-count`	Количество песен для collapsible-заголовка	`5`

Заметки

Поддерживаются только 5 песен. При необходимости шаблон можно расширить.
Цвета и ссылки кастомизируются параметрами.
Стили кольца и imagemap задаются в отдельном CSS-файле (см. ниже).

Стили

Для корректной работы шаблона рекомендуется подключить CSS:

[[MediaWiki:Common.css]] или [[Template:SetlistBox/styles.css]]

Файл можно скачать: SetlistBox.css

См. также

Help:Templates — руководство по шаблонам MediaWiki
Help:Collapsible elements — collapsible-блоки
Imagemap — использование imagemap на вики

@@ Line 1: / Line 1: @@
-<!-- Документация шаблона -->
+== Описание ==
+'''SetlistBox''' — шаблон для отображения сет-листа музыкального концерта. Включает:
+* список песен,
+* декоративную кольцевую диаграмму,
+* интерактивное collapsible-меню,
+* imagemap с ссылками на альбом или другие статьи.
-\== Описание ==
+Подходит для страниц выступлений, туров или сет-листов альбомов.
-'''SetlistBox''' — это шаблон для отображения сет-листа музыкального выступления с визуальными и интерактивными элементами:
-* нумерованный список песен;
+== Пример использования ==
-* кольцевая диаграмма (цветовая метка);
+<pre>
-* imagemap с интерактивными зонами;
+{{SetlistBox
-* collapsible-блок с кратким списком песен.
-\== Пример использования ==
-<pre>{{SetlistBox
 |song1=Friend, Please
 |note1=second known time
@@ Line 31: / Line 30: @@
 |imagemap-link2=Twenty One Pilots (album)
 |imagemap-text2=Twenty One Pilots
-|song-count=5}}</pre>
+|song-count=5
+}}
-\== Аргументы шаблона ==
+</pre>
-\=== Основные параметры песен ===
-; <code>song1</code> – <code>song5</code>: Названия песен (до 5 строк).
-; <code>note1</code> – <code>note5</code>: Примечания к песням (напр. ''live debut'', ''second known time'').
-\=== Настройки оформления ===
-; <code>ring-color</code>: Цвет кольца (формат CSS, напр. <code>#87B22A</code>).
-; <code>song-count</code>: Количество песен (отображается в заголовке collapsible-блока).
-\=== Данные об альбоме ===
+== Параметры ==
-; <code>album-name</code>: Название альбома.
+{| class="wikitable"
-; <code>album-link</code>: Ссылка на статью альбома.
+! Параметр !! Описание !! Пример
+|-
+| <code>song1</code> – <code>song5</code> || Названия песен || <code>Johnny Boy</code>
+|-
+| <code>note1</code> – <code>note5</code> || Подписи под песнями (примечания) || <code>live debut</code>
+|-
+| <code>ring-color</code> || Цвет кольца (в CSS-формате) || <code>#87B22A</code>
+|-
+| <code>album-name</code> || Название альбома в таблице || <code>Twenty One Pilots</code>
+|-
+| <code>album-link</code> || Ссылка на статью об альбоме || <code>Twenty One Pilots (album)</code>
+|-
+| <code>imagemap-file</code> || Название файла изображения для imagemap || <code>Emty.png</code>
+|-
+| <code>imagemap-link1</code> || Ссылка 1 в imagemap || <code>Twenty One Pilots (album)</code>
+|-
+| <code>imagemap-text1</code> || Текст ссылки 1 в imagemap || <code>Twenty One Pilots</code>
+|-
+| <code>imagemap-link2</code> || Ссылка 2 в imagemap || <code>Twenty One Pilots (album)</code>
+|-
+| <code>imagemap-text2</code> || Текст ссылки 2 в imagemap || <code>Twenty One Pilots</code>
+|-
+| <code>song-count</code> || Количество песен для collapsible-заголовка || <code>5</code>
+|}
-\=== Параметры imagemap ===
+== Заметки ==
-; <code>imagemap-file</code>: Название файла изображения (по умолчанию <code>Emty.png</code>).
+* Поддерживаются только 5 песен. При необходимости шаблон можно расширить.
-; <code>imagemap-link1</code>, <code>imagemap-link2</code>: Ссылки на статьи.
+* Цвета и ссылки кастомизируются параметрами.
-; <code>imagemap-text1</code>, <code>imagemap-text2</code>: Подписи ссылок.
+* Стили кольца и imagemap задаются в отдельном CSS-файле (см. ниже).
-\== Дополнительные замечания ==
+== Стили ==
+Для корректной работы шаблона рекомендуется подключить CSS:
-* Поддерживаются только первые 5 песен. При необходимости шаблон можно расширить.
+<pre>
-* Цвет и оформление можно адаптировать под тематику конкретного концерта.
+[[MediaWiki:Common.css]] или [[Template:SetlistBox/styles.css]]
-* Не забудьте подключить стили с помощью \[\[Template\:SetlistBox/styles.css]].
+</pre>
-\== См. также ==
+Файл можно скачать: [[Media:SetlistBox.css|SetlistBox.css]]
-* \[\[Template\:SetlistBox/styles.css]] — таблица стилей для шаблона
+== См. также ==
-* \[\[Help\:Templates]] — руководство по использованию шаблонов
+* [[Help:Templates]] — руководство по шаблонам MediaWiki
+* [[Help:Collapsible elements]] — collapsible-блоки
+* [[Imagemap]] — использование imagemap на вики
 <includeonly>
 [[Category:Музыкальные шаблоны]]
 [[Category:Шаблоны с интерактивным содержимым]]
+[[Category:Документация шаблонов]]
 </includeonly>