Дидани манбаъи Шаблон:ДарНақшҳоБоло/doc

{{docpage}}

== Внешний вид шаблона ==
{{ДарНақшҳоБоло}}
{{ДарНақшҳо|[[Филлион, Нейтан|Нейтан Филлион]]|капитан|Малькольм «Мэл» Рейнольдс}}
{{ДарНақшҳо|[[Джина Торрес]]|жена пилота|Зои Эллейн Уошбурн}}
{{ДарНақшҳо|[[Тьюдик, Алан|Алан Тьюдик]]|пилот|Хобан «Уош» Уошбурн}}
{{ДарНақшҳо|[[Морина Баккарин]]|компаньонка|Инара Серра}}
{{ДарНақшҳо|[[Адам Болдуин]]|наёмник|Джейн Кобб}}
{{ДарНақшҳо|[[Джуэл Стэйт]]|механик|Кейуиннит Ли «Кейли» Фрай}}
{{ДарНақшҳо|[[Шон Махер]]|доктор|Саймон Тэм}}
{{ДарНақшҳо|[[Саммер Глау]]|сестра доктора|Ривер Тэм}}
{{ДарНақшҳо|[[Рон Гласс]]|пастор|Дерриал Бук}}
{{ДарНақшҳоПоён}}

=== То же самое, но в 2 колонки ===
{{Кол|2}}
{{ДарНақшҳоБоло}}
{{ДарНақшҳо|[[Филлион, Нейтан|Нейтан Филлион]]|капитан|Малькольм «Мэл» Рейнольдс}}
{{ДарНақшҳо|[[Джина Торрес]]|жена пилота|Зои Эллейн Уошбурн}}
{{ДарНақшҳо|[[Тьюдик, Алан|Алан Тьюдик]]|пилот|Хобан «Уош» Уошбурн}}
{{ДарНақшҳо|[[Морина Баккарин]]|компаньонка|Инара Серра}}
{{ДарНақшҳо|[[Адам Болдуин]]|наёмник|Джейн Кобб}}
{{ДарНақшҳоПоён}}{{ДарНақшҳоБоло}}
{{ДарНақшҳо|[[Джуэл Стэйт]]|механик|Кейуиннит Ли «Кейли» Фрай}}
{{ДарНақшҳо|[[Шон Махер]]|доктор|Саймон Тэм}}
{{ДарНақшҳо|[[Саммер Глау]]|сестра доктора|Ривер Тэм}}
{{ДарНақшҳо|[[Рон Гласс]]|пастор|Дерриал Бук}}
{{ДарНақшҳоПоён}}
{{Конец кол}}

==== Неровность позиционирования верхнего края исправляется путём использования более старой версии колонко-шаблона ====
{{Col-begin}}
{{Col-2}}
{{ДарНақшҳоБоло}}
{{ДарНақшҳо|[[Филлион, Нейтан|Нейтан Филлион]]|капитан|Малькольм «Мэл» Рейнольдс}}
{{ДарНақшҳо|[[Джина Торрес]]|жена пилота|Зои Эллейн Уошбурн}}
{{ДарНақшҳо|[[Тьюдик, Алан|Алан Тьюдик]]|пилот|Хобан «Уош» Уошбурн}}
{{ДарНақшҳо|[[Морина Баккарин]]|компаньонка|Инара Серра}}
{{ДарНақшҳо|[[Адам Болдуин]]|наёмник|Джейн Кобб}}
{{ДарНақшҳоПоён}}
{{Col-2}}
{{ДарНақшҳоБоло}}
{{ДарНақшҳо|[[Джуэл Стэйт]]|механик|Кейуиннит Ли «Кейли» Фрай}}
{{ДарНақшҳо|[[Шон Махер]]|доктор|Саймон Тэм}}
{{ДарНақшҳо|[[Саммер Глау]]|сестра доктора|Ривер Тэм}}
{{ДарНақшҳо|[[Рон Гласс]]|пастор|Дерриал Бук}}
{{ДарНақшҳоПоён}}
{{Col-end}}
{{Комментарий|Примечание}} [https://ru.wikipedia.org/w/index.php?title=Принц_и_нищий_(фильм,_1937)&oldid=91015652 Если на странице справа от данной таблицы расположена карточка (инфокард), то начало отображения колонок будет смещено ниже её нижней грани (среза).] В таком случае [[Принц и нищий (фильм, 1937)#В ролях|приходится использовать предыдущий («неровный») вариант]].

== Назначение и состав ==
Шаблон предназначен для создания списка актёров. Может использоваться в статьях о фильмах, телесериалах и подобных. Состоит из трех различных шаблонов:
* {{tl|ДарНақшҳоБоло}} служит для создания шапки таблицы;
* {{tl|ДарНақшҳо}} служит для создания строк таблицы;
* {{tl|ДарНақшҳоПоён}} служит для закрытия таблицы.
Шаблон {{tl|ДарНақшҳо}} имеет пять необязательных параметров:
 <nowiki>{{ДарНақшҳо|Имя актёра|Уточнение перед|Имя персонажа|Уточнение после|Третья колонка}}</nowiki>
# '''Имя актёра''' — настоящее имя актёра;
# '''Уточнение перед''' — слова, стоящие перед именем персонажа и не влияющие на сортировку. Например, звания «доктор», «сержант» и другие. Эти слова будут отображены серым цветом;
# '''Имя персонажа''' — имя играемого персонажа на русском языке, влияет на сортировку. Например, «Джон Коннор»;
# '''Уточнение после''' — слова стоящие после имени персонажа, будут отображены серым цветом;
# '''Третья колонка''' — содержимое третьей колонки, если она активирована в шаблоне {{tl|ДарНақшҳоБоло}}.

== Использование ==
В простейшем случае данные шаблоны используются следующим образом:
 <nowiki>{{ДарНақшҳоБоло}}
{{ДарНақшҳо|Первый актёр||Иванов}}
{{ДарНақшҳо|Второй актёр||Петров}}
{{ДарНақшҳо|Третий актёр||Сидоров}}
{{ДарНақшҳоПоён}}</nowiki>

Приведённый выше код создаст такую таблицу:
{{ДарНақшҳоБоло}}
{{ДарНақшҳо|Первый актёр||Иванов}}
{{ДарНақшҳо|Второй актёр||Петров}}
{{ДарНақшҳо|Третий актёр||Сидоров}}
{{ДарНақшҳоПоён}}

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

 <nowiki>{{ДарНақшҳоБоло|title=<div style="font-weight:bold; font-size:110%;">В фильме снимались</div>}}
{{ДарНақшҳо|Первый актёр|сержант|Иванов}}
{{ДарНақшҳо|Второй актёр||Петров}}
{{ДарНақшҳо|Третий актёр||Сидоров}}
{{ДарНақшҳоПоён}}</nowiki>

Приведённый выше код создаст такую таблицу:
{{ДарНақшҳоБоло|title=<div style="font-weight:bold; font-size:110%;">В фильме снимались</div>}}
{{ДарНақшҳо|Первый актёр|сержант|Иванов}}
{{ДарНақшҳо|Второй актёр||Петров}}
{{ДарНақшҳо|Третий актёр||Сидоров}}
{{ДарНақшҳоПоён}}

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

 <nowiki>{{ДарНақшҳоБоло}}
{{ДарНақшҳо|Первый актёр|сержант|Иванов}}
{{ДарНақшҳо|Второй актёр||Петров|(младший)}}
{{ДарНақшҳо|Третий актёр||Сидоров}}
{{ДарНақшҳоПоён}}</nowiki>

{{ДарНақшҳоБоло}}
{{ДарНақшҳо|Первый актёр|сержант|Иванов}}
{{ДарНақшҳо|Второй актёр||Петров|(младший)}}
{{ДарНақшҳо|Третий актёр||Сидоров}}
{{ДарНақшҳоПоён}}

Можно отключить сортировку для колонки «Роль», когда это не является необходимым или попусту является бессмысленным в виду большого количества неизвестных имен (значений для третьего параметра). Для этого следует использовать параметр SecondColUnsortable шаблона {{tl|ДарНақшҳоБоло}}, присвоив ему любое значение.
 <nowiki>{{ДарНақшҳоБоло|SecondColUnsortable=1}}
{{ДарНақшҳо|Первый актёр|сержант|Иванов}}
{{ДарНақшҳо|Второй актёр|прохожий в толпе|}}
{{ДарНақшҳо|Третий актёр|таинственный незнакомец|}}
{{ДарНақшҳоПоён}}</nowiki>

{{ДарНақшҳоБоло|SecondColUnsortable=1}}
{{ДарНақшҳо|Первый актёр|сержант|Иванов}}
{{ДарНақшҳо|Второй актёр|прохожий в толпе|}}
{{ДарНақшҳо|Третий актёр|таинственный незнакомец|}}
{{ДарНақшҳоПоён}}

Также возможно отключение сортировки для колонки «Роль» посредством постановки произвольного значения первым параметром шаблона {{tl|ДарНақшҳоБоло}}, однако такой способ устарел и не рекомендуется к использованию.

=== Использование третьей колонки ===
В некоторых случаях необходимо использование в таблице ролей третьей колонки — например, для указания номеров сезонов телесериала, в которых имеются те или иные действующие лица. Для использования третьей колонки необходимо задать нужное значение параметру ThirdCol шаблона {{tl|ДарНақшҳоБоло}} — это значение будет именем третьей колонки. В шаблоне {{tl|ДарНақшҳо}} достаточно лишь использовать пятый параметр.

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

 <nowiki>{{ДарНақшҳоБоло|ThirdCol=Сезоны}}
{{ДарНақшҳо|[[Хью Лори]]|доктор|Грегори Хаус||1—8}}
{{ДарНақшҳо|[[Лиза Эдельштейн]]||Лиза Кадди||1—7}}
{{ДарНақшҳо|[[Оливия Уайлд]]||Реми Хадли|(Тринадцатая)|4—7}}
{{ДарНақшҳоПоён}}</nowiki>

{{ДарНақшҳоБоло|ThirdCol=Сезоны}}
{{ДарНақшҳо|[[Хью Лори]]|доктор|Грегори Хаус||1—8}}
{{ДарНақшҳо|[[Лиза Эдельштейн]]||Лиза Кадди||1—7}}
{{ДарНақшҳо|[[Оливия Уайлд]]||Реми Хадли|(Тринадцатая)|4—7}}
{{ДарНақшҳоПоён}}

Как видно, в данном примере сортировка для третьей колонки отключена. Для её включения нужно использовать параметр ThirdColSortable в шаблоне {{tl|ДарНақшҳоБоло}}, инициализировав этот параметр любым значением.

 <nowiki>{{ДарНақшҳоБоло|ThirdCol=Сезоны|ThirdColSortable=1}}
{{ДарНақшҳо|[[Хью Лори]]|доктор|Грегори Хаус||1—8}}
{{ДарНақшҳо|[[Лиза Эдельштейн]]||Лиза Кадди||1—7}}
{{ДарНақшҳо|[[Оливия Уайлд]]||Реми Хадли|(Тринадцатая)|4—7}}
{{ДарНақшҳоПоён}}</nowiki>

{{ДарНақшҳоБоло|ThirdCol=Сезоны|ThirdColSortable=1}}
{{ДарНақшҳо|[[Хью Лори]]|доктор|Грегори Хаус||1—8}}
{{ДарНақшҳо|[[Лиза Эдельштейн]]||Лиза Кадди||1—7}}
{{ДарНақшҳо|[[Оливия Уайлд]]||Реми Хадли|(Тринадцатая)|4—7}}
{{ДарНақшҳоПоён}}

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

 <nowiki>{{ДарНақшҳоБоло|ThirdCol=Сезоны|SecondColUnsortable=1|ThirdColSortable=1|title=В фильме снимались}}
{{ДарНақшҳо|[[Хью Лори]]|доктор|Грегори Хаус||1—8}}
{{ДарНақшҳо|[[Лиза Эдельштейн]]||Лиза Кадди||1—7}}
{{ДарНақшҳо|[[Оливия Уайлд]]||Реми Хадли|(Тринадцатая)|4—7}}
{{ДарНақшҳоПоён}}</nowiki>

{{ДарНақшҳоБоло|ThirdCol=Сезоны|SecondColUnsortable=1|ThirdColSortable=1|title=В фильме снимались}}
{{ДарНақшҳо|[[Хью Лори]]|доктор|Грегори Хаус||1—8}}
{{ДарНақшҳо|[[Лиза Эдельштейн]]||Лиза Кадди||1—7}}
{{ДарНақшҳо|[[Оливия Уайлд]]||Реми Хадли|(Тринадцатая)|4—7}}
{{ДарНақшҳоПоён}}

== Оформление ==
Пожалуйста, придерживайтесь следующих правил:
# [[Википедия:Интервики#Ссылки в тексте|Не делайте прямые ссылки]] на другие языковые разделы, для этого пользуйтесь шаблоном {{tl|Не переведено}}.

Пример правильно оформленного списка: [[Миссия «Серенити»]].

== Код для копирования ==
 <nowiki>{{ДарНақшҳоБоло}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳо|||||}}
{{ДарНақшҳоПоён}}</nowiki>

== templatedata ==
<templatedata>
{
        "description": "Оформляет список актёров. Каждое использование добавляет строку в таблицу. Может использоваться в статьях о фильмах, телесериалах и подобных. До него ставится шаблон ДарНақшҳоБоло, после - ДарНақшҳоПоён. ",
        "params": {
                "1": {
                        "label": "Имя актёра",
                        "description": "настоящее имя актёра",
                        "type": "string",
                        "required": false
                },
                "2": {
                        "label": "Уточнение перед",
                        "description": "слова, стоящие перед именем персонажа и не влияющие на сортировку. Например, звания «доктор», «сержант» и другие. Эти слова будут отображены серым цветом",
                        "type": "string",
                        "required": false
                },
                "3": {
                        "label": "Имя персонажа",
                        "description": "имя играемого персонажа на русском языке, влияет на сортировку. Например, «Джон Коннор»",
                        "type": "string",
                        "required": false
                },
                "4": {
                        "label": "Уточнение после ",
                        "description": "слова стоящие после имени персонажа, будут отображены серым цветом",
                        "type": "string",
                        "required": false
                },
                "5": {
                        "label": "Третья колонка",
                        "description": "содержимое третьей колонки, если она активирована в шаблоне ДарНақшҳоБоло",
                        "type": "string",
                        "required": false
                }
        }
}
</templatedata>

== См. также ==
Для создания списка фильмов в которых снимался определённый актёр, используйте шаблоны серии {{tl|ВФильме}}
<includeonly>{{#if:{{{nocat|}}}||[[Категория:Шаблоны:Фильмография]]}}</includeonly>