Template:SetlistBox/doc: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
No edit summary
Line 1: Line 1:
<!-- Документация шаблона SetlistBox -->




== Описание ==
\== Назначение ==
'''SetlistBox''' — шаблон для отображения сет-листа музыкального концерта. Включает:
Шаблон '''SetlistBox''' предназначен для удобного оформления сет-листов концертов или выступлений, с возможностью указания комментариев, интерактивным блоком и настраиваемым визуальным стилем.
* список песен,
 
* декоративную кольцевую диаграмму,
* интерактивное collapsible-меню,
* imagemap с ссылками на альбом или другие статьи.


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


== Пример использования ==
<pre>
<pre>
{{SetlistBox
{{SetlistBox
Line 34: Line 30:
</pre>
</pre>


== Параметры ==
|
{| class="wikitable"
{{SetlistBox
! Параметр !! Описание !! Пример
|song1=Friend, Please
|-
|note1=second known time
| <code>song1</code> – <code>song5</code> || Названия песен || <code>Johnny Boy</code>
|song2=Trapdoor
|-
|note2=second known time
| <code>note1</code> – <code>note5</code> || Подписи под песнями (примечания) || <code>live debut</code>
|song3=Johnny Boy
|-
|song4=March To The Sea
| <code>ring-color</code> || Цвет кольца (в CSS-формате) || <code>#87B22A</code>
|note4=(live debut)
|-
|song5=Fall Away
| <code>album-name</code> || Название альбома в таблице || <code>Twenty One Pilots</code>
|note5=second known time
|-
|ring-color=#87B22A
| <code>album-link</code> || Ссылка на статью об альбоме || <code>Twenty One Pilots (album)</code>
|album-name=Twenty One Pilots
|-
|album-link=Twenty One Pilots (album)
| <code>imagemap-file</code> || Название файла изображения для imagemap || <code>Emty.png</code>
|imagemap-file=Emty.png
|-
|imagemap-link1=Twenty One Pilots (album)
| <code>imagemap-link1</code> || Ссылка 1 в imagemap || <code>Twenty One Pilots (album)</code>
|imagemap-text1=Twenty One Pilots
|-
|imagemap-link2=Twenty One Pilots (album)
| <code>imagemap-text1</code> || Текст ссылки 1 в imagemap || <code>Twenty One Pilots</code>
|imagemap-text2=Twenty One Pilots
|-
|song-count=5
| <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>
|}
|}


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


== Стили ==
| ! Пример                                                |
Для корректной работы шаблона рекомендуется подключить CSS:
| -------------------------------------------------------- |
| <code>song1</code>–<code>song5</code>                    |
| Название песен от первой до пятой.                      |
| <code>song1=Friend, Please</code>                        |
| -                                                        |
| <code>note1</code>–<code>note5</code>                    |
| Примечания или комментарии к песням (опционально).      |
| <code>note1=live debut</code>                            |
| -                                                        |
| <code>ring-color</code>                                  |
| Цвет кольцевой диаграммы (CSS-код).                      |
| <code>ring-color=#87B22A</code>                          |
| -                                                        |
| <code>album-name</code>                                  |
| Отображаемое название альбома.                          |
| <code>album-name=Twenty One Pilots</code>                |
| -                                                        |
| <code>album-link</code>                                  |
| Ссылка на статью о соответствующем альбоме.              |
| <code>album-link=Twenty One Pilots (album)</code>        |
| -                                                        |
| <code>imagemap-file</code>                              |
| Файл изображения для использования в imagemap.          |
| <code>imagemap-file=Emty.png</code>                      |
| -                                                        |
| <code>imagemap-link1</code>, <code>imagemap-link2</code> |
| Ссылки для интерактивных областей imagemap.              |
| <code>imagemap-link1=Twenty One Pilots (album)</code>    |
| -                                                        |
| <code>imagemap-text1</code>, <code>imagemap-text2</code> |
| Текст подсказок для интерактивных областей imagemap.    |
| <code>imagemap-text1=Twenty One Pilots</code>            |
| -                                                        |
| <code>song-count</code>                                  |
| Число песен, отображаемое в раскрывающемся списке.      |
| <code>song-count=5</code>                                |
| }                                                        |
 
\== Описание параметров ==
{| class="wikitable" style="width:100%;"
! Параметр
! Описание


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


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


== См. также ==
\== Дополнительные сведения ==
* [[Help:Templates]] — руководство по шаблонам MediaWiki
* [[Help:Collapsible elements]] — collapsible-блоки
* [[Imagemap]] — использование imagemap на вики


<includeonly>
* Шаблон поддерживает отображение до 5 песен. Для увеличения количества песен необходима модификация шаблона.
[[Category:Музыкальные шаблоны]]
* Стилизация настраивается через отдельный файл стилей .
[[Category:Шаблоны с интерактивным содержимым]]
[[Category:Документация шаблонов]]
</includeonly>

Navigation menu