Модуль:RoundN/doc

Это страница документации Модуль:RoundN.

Этот модуль оценён как готовый к использованию. Предполагается, что все баги устранены и он готов для широкого использования. Его можно указывать на справочных страницах и рекомендовать к использованию новым участникам. Для его изменения и тестирования, пожалуйста, используйте песочницу.

Это модуль для предназначен для построения турнирных сеток различных соревнований.

Использование[править код]

Основная команда {{#invoke:RoundN|main|columns=Х]}}, где Х — количество стадий турнира (3 стадии для 8 команд, 4 стадии для 16 команд и т. д.).

Альтернативная, сокращенная форма {{#invoke:RoundN|N16}} (или любая степень двойки от 2 до 512) эквивалентна {{#invoke:RoundN|main|columns = 4}}.

Список параметров[править код]

Параметр Описание

|columns =

Количество столбцов/стадий (3 стадии для 8 команд, 4 стадии для 16 и т. д.)

Примечание: Если значение параметра |columns = больше или равно 4 по умолчание отображается поле для игры за третье место. Если же |columns = менее 4 (от 2 до 8 команд) — по умолчанию скрыто.

{{{#}}}

Неименованные параметры считываются последовательно группами по 5 таким образом, что:

Пример

{{#invoke:RoundN|main|columns=2
|День 1|A|'''7'''|B|5
|День 2|C|       |D|
|TDB   |A|       | |
}}

Полуфинал		Финал

День 1

A	7
		TDB
B	5
		A
День 2

C

D

Размещение каждой группы из 5 параметров на новой строке необязательно, но облегчает чтение. Рекомендуется добавлять в виде комментариев к коду наименования параметров  и стадию турнира 

|style =

Установите параметр |style =, чтобы добавить пользовательский CSS в таблицу. {{#invoke:RoundN|main|columns=2|style=width:20em; font-size:70%}}

	Полуфинал				Финал

Чтобы выровнять весь блок по центру, используйте |style = margin:auto;

|scroll_height =

Для больших таблиц установите |scroll_height = на желаемую высоту. {{#invoke:RoundN|main|columns=2|scroll_height=9em}}

	Полуфинал				Финал

	Полуфинал				Финал

Примечание Работает путём дублирования всей таблицы, а затем использования CSS для привязки клона таблицы к верхней части. Предположительно, для очень больших таблиц это может привести к значительному объёму дополнительного HTML-кода для загрузки по сравнению с использованием параметра |scroll_head_unlock =.

|scroll_head_unlock =

Если необходимо, чтобы заголовок прокручивался вместе с таблицей (например, если требуется большая область просмотра), установите параметр |scroll_head_unlock = yes {{#invoke:RoundN|main|columns=2|scroll_height=9em|scroll_head_unlock=yes}}

	Полуфинал				Финал

|skipmatchN =

Если установлено, поля для N-й группы матчей отображаться не будут. Чаще всего используется для плей-офф или когда количество команд, играющих в первом раунде, не равно степени 2.

{{#invoke:RoundN|main|columns=2|skipmatch2=yes}}

	Полуфинал				Финал

Запись вида: |skipmatch = 1-2;4;6-7 равнозначна записи:

|skipmatch1=yes
|skipmatch2=yes
|skipmatch4=yes
|skipmatch6=yes
|skipmatch7=yes

Примечания:

Модуль не требует начальных нулей в параметре, то есть |skipmatch001 = совпадает с |skipmatch1 = (хотя это может облегчить чтение кода шаблона, если ввести соответствующее количество нулей);
5 параметров, которые заполнили бы пропущенное поле, будут проигнорированы независимо от значения, если для параметра |omit_blanks = не установлено значение yes (см. ниже);
Ранее пропуск матча действовал только в первом раунде. Это ограничение больше не применяется.

|omit_blanks = Если для параметра |omit_blanks = установлено значение yes, то все параметры, которые были бы пропущены, вместо этого будут перенесены в следующее поле без пропусков. (По умолчанию это отключено, поскольку большинство шаблонов, созданных до выпуска этого модуля, должны были использовать пустые параметры в качестве заполнителей).

|bold_winner =

Параметр bold_winner принимает значения high или low, что автоматически выделит жирным шрифтом текст с более высоким или более низким баллом соответственно. Другими словами, установите значение low, если выигрывает участник с более низким баллом, и high, если выигрывает участник с более высоким баллом.

Пример

{{#invoke:RoundN|main|columns=2|bold_winner=low
|День 1|A|7    |B|5
|День 2|C|7 (3)|D|5 (2)
|TDB   |B|     |D|
}}

Полуфинал		Финал

День 1

A	7
		TDB
B	5
		B
День 2
		D
C	7 (3)

D	5 (2)

Примечания:

При вводе результата, который включает в себя не только (например: 7 (3)) модуль сначала удалит все нецифровые символы и объединит остальные. Так код 7 (3) и код 5 (2) будут преобразованы перед сравнением в 73 и 52, соответственно. Это должно быть верно для большинства случаев, однако вы можете переопределить значение, используя параметр manualboldmatchN;
Если значения равны или не содержат цифр, то ни одно из них не будет выделено жирным шрифтом;
Это не приводит к удалению уже существующего форматирования.

|manualboldmatchN = Аналогично параметрам |skipmatch = вы можете использовать |manualboldmatch = группой чтобы предотвратить автоматическое выделение жирным шрифтом (|manualboldmatch = 1-2;4;6-7). Опять же, как и в случае со |skipmatch =, начальные нули могут быть добавлены по желанию.

|previewnumbers = Установите параметр |previewnumbers = yes, чтобы отображать номера рядом с каждой группой (полезно для |skipmatch = и |manualboldmatch =) при просмотре на странице шаблона. Обратите внимание, что эти цифры не будут отображаться в статье.

|RD## =

Используйте |RD## =, заменив # на нужный столбец таким образом, чтобы 1 был крайним левым кругом, а X - крайним правым, |columns = X

{{#invoke:RoundN|N128
|RD2 = {{red|'''Второй раунд'''}}
|RD7 = {{red|'''Чемпионат'''}}
|RD8 = {{red|'''Прочее'''}}
|scroll_height=15em
}}

Раунд из 128

Второй раунд

Раунд из 32

Раунд из 16

Четвертьфинал

Полуфинал

Чемпионат

Прочее

Раунд из 128

Второй раунд

Раунд из 32

Раунд из 16

Четвертьфинал

Полуфинал

Чемпионат

Прочее

Примечание: RD[N+1] = матч за третье место и = параметру |Consol =, если последний опущен, и наоборот RD[N+1] игнорируется, если параметр |Consol = заполнен. При этом RD[N+1] выглядит более интуитивно и предпочтительно.

|3rdplace = По умолчанию для |3rdplace = установлено значение yes, если |columns = больше 3, и no в противном случае.

|Consol =

Установите параметр |Consol = name, чтобы изменить метку «Третье место» на «name». Рекомендуется формат RD#, где # = столбцы + 1. Данный параметр существует только для обеспечения совместимости со старыми шаблонами и признан неинтуитивным.

{{#invoke:RoundN|main|columns=1
|3rdplace=yes
|Consol=Второй финал
}}

	Финал










	Второй финал

|color =

Включает подсветку призёров командой |color = yes

{{#invoke:RoundN|main|columns=1
|color=yes
|3rdplace=yes
||Команда А|1|Команда Б|2
||Команда В|3|Команда Г|4
}}

	Финал



	Команда А	1

	Команда Б	2




	Матч за 3-е место



	Команда В	3

	Команда Г	4

Примечание: Когда задано значение |color = yes, строки жёстко закодированы так, чтобы они были окрашены, как показано в примере выше. Чтобы раскрасить «правильные» ячейки, вы также должны активировать параметр |bold_winner = (см. выше). Таким образом, модуль сможет правильно идентифицировать и раскрасить победителей и проигравших.

{{#invoke:RoundN|main|columns=1
|color=yes
|bold_winner=high
|3rdplace=yes
||Команда А|1|Команда Б|2
||Команда В|3|Команда Г|4
}}

	Финал



	Команда А	1

	Команда Б	2




	Матч за 3-е место



	Команда В	3

	Команда Г	4

|color_repechage =

Добавьте параметр |color_repechage = yes для случаев когда победитель финала награждается бронзовой медалью.

{{#invoke:RoundN|main|columns=1
|color_repechage=yes
|3rdplace=yes
||Команда А|1|Команда Б|2
||Команда В|3|Команда Г|4
}}

	Финал



	Команда А	1

	Команда Б	2




	Матч за 3-е место



	Команда В	3

	Команда Г	4

Примечания:

Когда задано значение |color_repechage = yes, строки жёстко закодированы так, чтобы они были окрашены, как показано в примере выше. Чтобы раскрасить «правильные» ячейки, вы также должны активировать параметр |bold_winner = (см. выше). Таким образом, модуль сможет правильно идентифицировать и раскрасить победителей и проигравших.
Когда задано значение |color_repechage = yes и название финальной секции переопределено, как в случаях, когда есть два бронзовых призёра, все видимые победители финального этапа будут окрашены в бронзовый цвет.

{{#invoke:RoundN|main|columns=3
|bold_winner     = high
|color_repechage = yes
|flex_tree       = yes
|skipmatch       = 2;4;7
|omit_blanks     = yes
|RD1             = Переигровка
|RD2             = Игры за бронзу
|RD3             = omit_label
|1|Команда А| 3|Команда Б| 2
|2|Команда В| 6|Команда Г| 5
|3|Команда Д| 8|Команда Е| 7
|4|Команда Ж|10|Команда З|11
}}

Переигровка		Игры за бронзу

1

Команда А	3
		3
Команда Б	2
		Команда Д	8

		Команда Е	7




2

Команда В	6
		4
Команда Г	5
		Команда Ж	10

		Команда З	11

|team-width = При необходимости установите параметр |team-width = на желаемую ширину. (по умолчанию 170px). Менять ширину данного столбца без особой необходимости не рекомендуется так как она подбирается автоматически.

|score-width = При необходимости установите параметр |score-width = на желаемую ширину. (по умолчанию 30px) Менять ширину данного столбца без особой необходимости не рекомендуется так как она подбирается автоматически.

|widescore = Значение |widescore = yes в основном равно |score-width = 40. Предусмотрено для совместимости. Игнорируется, если задан параметр |score-width =.

|score-boxes =

Установите в параметре |score-boxes = желаемое количество полей для подсчета очков за матч. (по умолчанию 1). За номером может следовать + sum, что добавит еще одно поле для подсчёта очков к сумме всех остальных.

{{#invoke:RoundN|main|columns=3
|score-boxes     = 3+ sum
|bold_winner     = high
|color_repechage = yes
|flex_tree       = yes
|skipmatch       = 2;4;7
|omit_blanks     = yes
|RD1             = Переигровка
|RD2             = Игры за бронзу
|RD3             = omit_label
|1|Команда А| 3| 3| 3|Команда Б| 2| 2| 2
|2|Команда В| 6| 6| 6|Команда Г| 5| 5| 5
|3|Команда Д| 8| 8| 8|Команда Е| 7| 7| 7
|4|Команда Ж|10|10|10|Команда З|11|11|11
}}

Переигровка					Игры за бронзу

1

Команда А	3	3	3	9
					3
Команда Б	2	2	2	6
					Команда Д	8	8	8	24

					Команда Е	7	7	7	21




2

Команда В	6	6	6	18
					4
Команда Г	5	5	5	15
					Команда Ж	10	10	10	30

					Команда З	11	11	11	33

|flex_tree = Установите параметр |flex_tree = yes, чтобы сделать скобки по вертикали более компактными. То есть, чтобы между матчами одного раунда оставалось меньше места.

|short_brackets =

Установите параметр |short_brackets = yes, чтобы сделать скобки более компактными по горизонтали. То есть, чтобы между матчами следующих раундов оставалось меньше места.

{{#invoke:RoundN|main|columns=3
|short_brackets = yes
|flex_tree      = yes
|score-boxes    = 3+ sum
|bold_winner    = high
|skipmatch      = 2;4;7
|omit_blanks    = yes
|RD1            = Переигровка
|RD2            = Игры за бронзу
|RD3            = omit_label
|1|Команда А| 3| 3| 3|Команда Б| 2| 2| 2
|2|Команда В| 6| 6| 6|Команда Г| 5| 5| 5
|3|Команда Д| 8| 8| 8|Команда Е| 7| 7| 7
|4|Команда Ж|10|10|10|Команда З|11|11|11
}}

Переигровка					Игры за бронзу

1

Команда А	3	3	3	9
					3
Команда Б	2	2	2	6
					Команда Д	8	8	8	24

					Команда Е	7	7	7	21




2

Команда В	6	6	6	18
					4
Команда Г	5	5	5	15
					Команда Ж	10	10	10	30

					Команда З	11	11	11	33

Недокументированные параметры[править код]

Обратите внимание, что некоторые из этих функций, возможно, не были задокументированы из-за неполной реализации.

|no_column_head =
|branch_upwards =

См. также[править код]

Модуль:RoundN/doc

Содержание

Использование[править код]

Список параметров[править код]

Недокументированные параметры[править код]

См. также[править код]

Навигация

Модуль:RoundN/doc

Использование[править код]

Список параметров[править код]

Недокументированные параметры[править код]

См. также[править код]

Навигация

Поиск