Документация

Внешний вид шаблона

править
Спектакль Роль
«Диалог самцов» Ио[1] Ио[1]
«Распутник» мадемуазель Гольдбах[2] мадемуазель Гольдбах[2]
«Убийство — дело семейное» Изабелла Изабелла
«Приключения домовых» русалка[3] русалка[3]
«Именины Бабы-Яги»[4]
«Ловушка для Деда Мороза» Танька, младшая Баба Яга[5] Танька, младшая Баба Яга[5]
«Любовь — книга золотая»

Назначение и состав

править

Шаблон предназначен для создания списка ролей актёра. Должен использоваться в статьях об актёрах, актрисах и т.д. Состоит из трёх различных шаблонов:

  • {{РолиТеатрВерх}} служит для создания шапки таблицы;
  • {{РолиТеатр}} служит для создания строк таблицы;
  • {{РолиТеатрНиз}} служит для закрытия таблицы.

Шаблон {{РолиТеатр}} имеет пять необязательных параметров:

{{РолиТеатр|Название спектакля|Уточнение перед|Имя персонажа|Уточнение после|Третья колонка}}
  1. Название спектакля — полное название спектакля;
  2. Уточнение перед — слова, стоящие перед именем персонажа и не влияющие на сортировку. Например, звания «доктор», «сержант» и другие. Эти слова будут отображены серым цветом;
  3. Имя персонажа — имя играемого персонажа на русском языке, влияет на сортировку. Например, «Джон Коннор»;
  4. Уточнение после — слова стоящие после имени персонажа, будут отображены серым цветом, например эсквайр;
  5. Третья колонка — содержимое третьей колонки, если она активирована в шаблоне {{РолиТеатрВерх}}.

Использование

править

В простейшем случае данные шаблоны используются следующим образом:

{{РолиТеатрВерх}}
{{РолиТеатр|Первый спектакль||Отелло}}
{{РолиТеатр|Второй спектакль||Гамлет}}
{{РолиТеатр|Третий спектакль||Годунов}}
{{РолиТеатрНиз}}

Приведённый выше код создаст такую таблицу:

Спектакль Роль
Первый спектакль Отелло Отелло
Второй спектакль Гамлет Гамлет
Третий спектакль Годунов Годунов

Как видите, колонки можно сортировать по алфавиту, причём сортировка идёт по словам переданным в качестве третьего параметра. Обратите внимание, что второй параметр хоть и не используется в данном примере, но всё равно должен быть передан. Также можно явно задать заголовок таблицы, используя параметр title шаблона {{РолиТеатрВерх}}. Пример с использованием заголовка и второго параметра:

{{РолиТеатрВерх|title=<div style="font-weight:bold; font-size:110%;">В театре таком-то</div>}}
{{РолиТеатр|Первый спектакль|майор|Яго}}
{{РолиТеатр|Второй спектакль||Гамлет}}
{{РолиТеатр|Третий спектакль||Годунов}}
{{РолиТеатрНиз}}

Приведённый выше код создаст такую таблицу:

В театре таком-то
Спектакль Роль
Первый спектакль Яго майор Яго
Второй спектакль Гамлет Гамлет
Третий спектакль Годунов Годунов

Как видите, сортировка идёт по фамилиям, игнорируя слово «Сержант». Чтобы не вводить читателя в недоумение из-за такой, не совсем очевидной, сортировки, слово «Сержант» отображено серым цветом. Также серым цветом будет отображена строка, переданная в качестве четвёртого параметра:

{{РолиТеатрВерх}}
{{РолиТеатр|Первый спектакль|майор|Яго}}
{{РолиТеатр|Второй спектакль||Гамлет|(эсквайр)}}
{{РолиТеатр|Третий спектакль||Годунов}}
{{РолиТеатрНиз}}
Спектакль Роль
Первый спектакль Яго майор Яго
Второй спектакль Гамлет (эсквайр)
Третий спектакль Годунов Годунов

Можно отключить сортировку для колонки «Роль», когда это не является необходимым или попусту является бессмысленным в виду большого количества неизвестных имен (значений для третьего параметра). Для этого следует использовать параметр SecondColUnsortable шаблона {{ВРоляхВерх}}, присвоив ему любое значение.

{{РолиТеатрВерх|SecondColUnsortable=1}}
{{ВРолях|Первый спектакль|майор|Яго}}
{{ВРолях|Второй спектакль|прохожий в толпе|}}
{{ВРолях|Третий спектакль|таинственный незнакомец|}}
{{РолиТеатрНиз}}
Спектакль Роль
Первый спектакль Яго майор Яго
Второй спектакль прохожий в толпе
Третий спектакль таинственный незнакомец

Также возможно отключение сортировки для колонки «Роль» посредством постановки произвольного значения первым параметром шаблона {{ВРоляхВерх}}, однако такой способ устарел и НАСТОЯТЕЛЬНО не рекомендуется к использованию.

Использование третьей колонки

править

В некоторых случаях необходимо использование в таблице ролей третьей колонки — например, для примечаний, которые могут понадобиться для уточнения информации о спектакле или роли. Для использования третьей колонки необходимо задать нужное значение параметру ThirdCol шаблона {{РолиТеатрВерх}} — это значение будет именем третьей колонки. В шаблоне {{РолиТеатр}} достаточно лишь использовать пятый параметр.

Данная возможность реализуется следующим образом:

{{РолиТеатрВерх|ThirdCol=Примечания}}
{{РолиТеатр|[[Отелло]]|ревнивец|Мавр||бенефис}}
{{РолиТеатр|[[Гамлет]]||Король||детский утренник}}
{{РолиТеатр|[[Борис Годунов]]||Бориска|(на царствие)|корпоратив}}
{{РолиТеатрНиз}}
Спектакль Роль Примечания
Отелло Мавр ревнивец Мавр бенефис
Гамлет Король Король детский утренник
Борис Годунов Бориска Бориска (на царствие) корпоратив

Как видно, в данном примере сортировка для третьей колонки отключена. Для её включения нужно использовать параметр ThirdColSortable в шаблоне {{ВРоляхВерх}}, инициализировав этот параметр любым значением.

{{РолиТеатрВерх|ThirdCol=Примечания|ThirdColSortable=1}}
{{РолиТеатр|[[Отелло]]|ревнивец|Мавр||бенефис}}
{{РолиТеатр|[[Гамлет]]||Король||детский утренник}}
{{РолиТеатр|[[Борис Годунов]]||Бориска|(на царствие)|корпоратив}}
{{РолиТеатрНиз}}
Спектакль Роль Примечания
Отелло Мавр ревнивец Мавр бенефис
Гамлет Король Король детский утренник
Борис Годунов Бориска Бориска (на царствие) корпоратив

Шаблон, в котором использован весь возможный функционал (сортировка второй колонки отключена, сортировка третьей колонки включена), может выглядеть так:

{{РолиТеатрВерх|ThirdCol=Примечания|SecondColUnsortable=1|ThirdColSortable=1|title=В [[Ромэн|театре Ромэн]]}}
{{РолиТеатр|[[Отелло]]|ревнивец|Мавр||бенефис}}
{{РолиТеатр|[[Гамлет]]||Король||детский утренник}}
{{РолиТеатр|[[Борис Годунов]]||Бориска|(на царствие)|корпоратив}}
{{РолиТеатрНиз}}
В театре Ромэн
Спектакль Роль Примечания
Отелло Мавр ревнивец Мавр бенефис
Гамлет Король Король детский утренник
Борис Годунов Бориска Бориска (на царствие) корпоратив

Оформление

править

Пожалуйста, придерживайтесь следующих правил:

  1. Не делайте прямые ссылки на другие языковые разделы, для этого пользуйтесь шаблоном {{iw}}.

Пример оформленного списка: Евгения Серебренникова.

Код для копирования

править
{{РолиТеатрВерх}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатр|||||}}
{{РолиТеатрНиз}}

templatedata

править

Оформляет список актёров. Каждое использование добавляет строку в таблицу. Должен использоваться в статьях о спектаклях, телеспектаклях и подобных. До него ставится шаблон РолиТеатрВерх, после - РолиТеатрНиз.

Параметры шаблона[Править данные шаблона]

ПараметрОписаниеТипСтатус
Название спектакля1

Полное название спектакля

Строковый (без форматирования)необязательный
Уточнение перед2

слова, стоящие перед именем персонажа и не влияющие на сортировку. Например, звания «доктор», «сержант» и другие. Эти слова будут отображены серым цветом

Строковый (без форматирования)необязательный
Имя персонажа3

имя играемого персонажа на русском языке, влияет на сортировку. Например, «Джон Коннор»

Строковый (без форматирования)необязательный
Уточнение после 4

слова стоящие после имени персонажа, будут отображены серым цветом

Строковый (без форматирования)необязательный
Третья колонка5

содержимое третьей колонки, если она активирована в шаблоне ВРоляхВерх

Строковый (без форматирования)необязательный

См. также

править

Для создания списка театральных спектаклей (репертуаров), используйте шаблоны серии {{Репертуар}}

Примечания

править