Andrew: Новая страница: «Модуль строит для кругового футбольного турнира турнирную таблицу, шахматку результатов и, по желанию, таблицу положения команд по турам. Очки, разница мячей, места, карточки и снятия очков считаются автоматически по данным о матчах. == Использование ==...»

2026-09-24T12:58:56Z

Новая страница: «Модуль строит для кругового футбольного турнира турнирную таблицу, шахматку результатов и, по желанию, таблицу положения команд по турам. Очки, разница мячей, места, карточки и снятия очков считаются автоматически по данным о матчах. == Использование ==...»

Новая страница

Модуль строит для кругового футбольного турнира турнирную таблицу, шахматку результатов и, по желанию, таблицу положения команд по турам. Очки, разница мячей, места, карточки и снятия очков считаются автоматически по данным о матчах.

== Использование ==
Модуль вызывается напрямую из статьи:

<code><nowiki>{{#invoke:</nowiki>{{ROOTPAGENAME}}<nowiki>|main| … }}</nowiki></code>

Модуль читает только параметры самого вызова <code>#invoke</code>. Если нужен шаблон-обёртка, он должен явно передавать в модуль каждый параметр.

Модуль выводит по порядку:
# турнирную таблицу — без собственного заголовка (заголовок раздела ставится в статье);
# строку «Критерии определения мест» и, если с какой-то команды снимались очки, блок «Примечания»;
# раздел '''«Результаты»''' с шахматкой;
# раздел '''«Положение команд по турам»''' — только при <code>show_progress = yes</code>.

Заголовки разделов — обычные вики-заголовки (по умолчанию <code><nowiki>=== … ===</nowiki></code>), поэтому они попадают в оглавление статьи. Уровень заголовков меняется параметром <code>heading_level</code>.

== Быстрый старт ==
<pre>
{{#invoke:Турнирная таблица|main
| teams = СПА;ЦСК;ЗЕН
| name_СПА = Спартак
| name_ЦСК = ЦСКА
| name_ЗЕН = Зенит
| match1 = 1;1;СПА;ЦСК;2:1
| match2 = 2;1;ЦСК;ЗЕН;0:0
| match3 = 3;1;ЗЕН;СПА;1:3
| match4 = 4;2;ЦСК;СПА;
| match5 = 5;2;ЗЕН;ЦСК;
| match6 = 6;2;СПА;ЗЕН;
}}
</pre>
Несыгранные матчи можно внести заранее с пустым счётом: в шахматке они видны как «—» и начинают учитываться, как только вписан счёт.

== Команды ==
{| class="wikitable"
! Параметр !! Описание
|-
| <code>teams</code> || '''Обязательный.''' Коды команд через «;», например <code>СПА;ЦСК;ЗЕН</code>. Порядок кодов — это порядок строк и столбцов шахматки и строк таблицы по турам; итоговая таблица сортируется сама. Коды должны быть уникальными. Удобнее всего короткие коды из букв и цифр без пробелов: они входят в имена других параметров.
|-
| <code>name_КОД</code> || Название команды, например <code>name_СПА = Спартак</code>. Можно использовать вики-разметку: <code><nowiki>name_СПА = [[ФК «Спартак»|Спартак]]</nowiki></code>. Если название не указано, выводится код.
|}

== Матчи ==
Каждый матч — отдельный параметр: <code>match1</code>, <code>match2</code> и так далее. '''Нумерация без пропусков:''' модуль читает матчи по порядку и останавливается на первом отсутствующем или пустом номере, поэтому матчи после пропуска не учитываются.

Части значения разделяются «;». Допускаются три формата:
{| class="wikitable"
! Формат !! Пример !! Примечание
|-
| <code>тур;круг;хозяева;гости;счёт</code> || <code>5;2;СПА;ЛОК;2:2</code> || Полный формат. Номер тура нужен для таблицы положения по турам, номер круга — для режима шахматки <code>resultsMode = round</code>.
|-
| <code>круг;хозяева;гости;счёт</code> || <code>2;СПА;ЛОК;2:2</code> || Матч не попадает в таблицу положения по турам.
|-
| <code>хозяева;гости;счёт</code> || <code>СПА;ЛОК;2:2</code> || Матч не попадает в таблицу положения по турам.
|}
Хозяева и гости указываются кодами из <code>teams</code>. Тур — число, круг — <code>1</code> или <code>2</code>.

Возможные значения счёта:
{| class="wikitable"
! Значение !! Что означает !! Что видно в шахматке
|-
| <code>2:1</code> (можно <code>2 : 1</code>) || Матч сыгран: голы хозяев, двоеточие, голы гостей || Счёт и цвет результата
|-
| пусто, <code>-</code> или <code>—</code> || Матч ещё не сыгран || —
|-
| <code>перенесён</code> или <code>перенесен</code> || Матч перенесён || перенесён
|-
| <code>отменён</code> или <code>отменен</code> || Матч отменён || отменён
|-
| что-либо другое || Счёт не распознан, матч не учитывается || ошибка: …
|}
Техническое поражение записывается обычным счётом, например <code>0:3</code>. Если за матч с команды ещё и сняли очки, это указывается отдельно — см. раздел [[#Снятие очков|«Снятие очков»]].

== Очки за результат ==
{| class="wikitable"
! Параметр !! По умолчанию !! Описание
|-
| <code>points_win</code> || 3 || Очки за победу
|-
| <code>points_draw</code> || 1 || Очки за ничью
|-
| <code>points_loss</code> || 0 || Очки за поражение
|}

== Критерии определения мест ==
Параметры <code>tie1</code> … <code>tie10</code> задают критерии в порядке применения: если по первому критерию команды равны, сравнивается второй, и так далее. Если не указан ни один, используется порядок '''очки → разница → забитые → победы → название'''. Если команды равны по всем критериям, выше та, чей код раньше по алфавиту.

{| class="wikitable"
! Значение !! Выше команда, у которой…
|-
| <code>очки</code> || больше очков (с учётом снятых)
|-
| <code>разница</code> || лучше разница забитых и пропущенных мячей
|-
| <code>забитые</code> || больше забитых мячей
|-
| <code>победы</code> || больше побед
|-
| <code>игры</code> || больше сыгранных матчей
|-
| <code>личные</code> || лучше результаты в матчах между всеми командами, набравшими столько же очков: сравниваются очки в этих матчах, затем разница мячей в них, забитые в них и победы в них. Снятые очки здесь не учитываются. Критерий имеет смысл только после <code>очки</code>.
|-
| <code>название</code> || название раньше по алфавиту (сравнивается текст параметра <code>name_КОД</code> как есть, вместе с разметкой)
|}
Под таблицей выводится строка «Критерии определения мест: …» с выбранным порядком. Нераспознанные значения модуль пропускает, но показывает в этой строке, так что по ней удобно проверять написание.

Пример: очки, затем личные встречи, затем общая разница мячей.
<pre>
| tie1 = очки
| tie2 = личные
| tie3 = разница
</pre>

== Цветовые зоны ==
Параметры <code>highlight1</code> … <code>highlight10</code> (без пропусков в нумерации) выделяют группы мест:

<code>highlightN = место;количество;класс;текст</code>

{| class="wikitable"
! Часть !! Описание
|-
| место || Первое место зоны
|-
| количество || Сколько мест подряд входит в зону (по умолчанию 1)
|-
| класс || CSS-класс. Строки зоны получают классы <code>highlight</code> и указанный, например <code>class="highlight green"</code>. Сами цвета задаются стилями вики (см. [[#Оформление|«Оформление»]]).
|-
| текст || Подпись зоны (необязательно). Может содержать ссылки и «;».
|}
Если хотя бы у одной зоны есть текст, в таблице появляется столбец «Повышение или выбывание»: подпись выводится одной объединённой ячейкой на всю зону, места между зонами — пустыми объединёнными ячейками. Зоны не должны пересекаться; места за пределами таблицы игнорируются.

<pre>
| highlight1 = 1;1;green;Выход в Лигу чемпионов
| highlight2 = 2;2;blue;Выход в Лигу конференций
| highlight3 = 15;2;red;Выбывание в Первую лигу
</pre>

== Шахматка ==
Раздел «Результаты». Каждой команде (в порядке <code>teams</code>) соответствуют две строки, столбцы — соперники. По умолчанию в первой строке — домашние матчи команды, во второй — выездные.

Счёт всегда записан как «хозяева:гости», а цвет ячейки показывает результат для команды строки: класс <code>ui green</code> — победа, <code>ui yellow</code> — ничья, <code>ui red</code> — поражение.

При <code>resultsMode = round</code> первая строка показывает матчи первого круга, вторая — второго (по номеру круга в <code>matchN</code>).

Шахматка рассчитана на двухкруговой турнир: каждая пара команд играет по одному разу на поле каждой из них.

== Положение команд по турам ==
Параметр <code>show_progress = yes</code> добавляет раздел «Положение команд по турам»: для каждого тура — место команды после всех матчей этого и предыдущих туров. Учитываются только матчи с номером тура (полный формат <code>matchN</code>); туры идут по возрастанию, строки — в порядке <code>teams</code>. Места определяются по тем же критериям, что и в итоговой таблице (личные встречи — только по матчам до этого тура включительно). Если ни у одного матча нет номера тура, вместо таблицы выводится пояснение.

Ячейки с определёнными местами можно выделить параметрами <code>progress_highlight1</code> … <code>progress_highlight10</code>:

<code>progress_highlightN = место;класс</code> — ячейка получает классы <code>highlight</code> и указанный.

<pre>
| show_progress = yes
| progress_highlight1 = 1;green
| progress_highlight2 = 16;red
</pre>

Снятие очков учитывается начиная с тура матча, к которому оно привязано, а ячейка этого тура получает ту же сноску, что и команда в итоговой таблице.

== Карточки ==
Карточки необязательны. Если они не указаны ни в одном матче и ни у одной команды, столбцов карточек в таблице нет. Если они указаны хотя бы где-нибудь, после столбца «О» появляются три столбца — у всех команд.

Карточки учитываются раздельно, как в подробной футбольной статистике, чтобы вторая жёлтая карточка не засчитывалась дважды:

{| class="wikitable"
! Столбец !! Вид !! Что считается
|-
| style="text-align:center" | || <code>yellow</code> || Жёлтые карточки — все предупреждения, кроме второй жёлтой, после которой игрок удалён
|-
| style="text-align:center" | || <code>yellowred</code> || Удаления за вторую жёлтую карточку — по одному на каждое такое удаление
|-
| style="text-align:center" | || <code>red</code> || Прямые красные карточки
|}

Как записывать разные случаи (один игрок в одном матче):
{| class="wikitable" style="text-align:center"
! Что произошло !! yellow !! yellowred !! red
|-
| style="text-align:left" | Одна жёлтая карточка || 1 || 0 || 0
|-
| style="text-align:left" | Две жёлтые карточки и удаление || 1 || 1 || 0
|-
| style="text-align:left" | Прямая красная карточка || 0 || 0 || 1
|-
| style="text-align:left" | Жёлтая, затем прямая красная || 1 || 0 || 1
|}
Общее число удалений команды равно сумме столбцов <code>yellowred</code> и <code>red</code>.

Карточки выводятся для справки и на места в таблице не влияют.

=== Карточки по матчам ===
<code>matchN_yellow</code>, <code>matchN_yellowred</code>, <code>matchN_red</code> — карточки в матче N в формате <code>хозяева:гости</code>:

<pre>
| match1 = 1;1;СПА;ЦСК;2:1
| match1_yellow = 2:3
| match1_yellowred = 0:1
</pre>
Здесь у хозяев две жёлтые карточки, у гостей — три жёлтые и одно удаление за вторую жёлтую. Неуказанный вид карточек считается как <code>0:0</code>. Карточки суммируются по всем матчам, где они указаны, независимо от счёта.

=== Итог команды ===
<code>yellow_КОД</code>, <code>yellowred_КОД</code>, <code>red_КОД</code> — итоговое количество карточек команды (целое неотрицательное число). Если у команды указан хотя бы один из этих параметров, все её карточки берутся только из них (неуказанные считаются нулём), а карточки из матчей этой команды не учитываются. У остальных команд карточки по-прежнему считаются по матчам.

<pre>
| yellow_ЗЕН = 41
| yellowred_ЗЕН = 2
| red_ЗЕН = 1
</pre>
Так удобно поступать, если поматчевой статистики нет или итог нужно привести в соответствие с официальными данными.

== Снятие очков ==
Снятие очков привязывается к конкретному матчу:

<code>matchN_deduction = код;очки;причина</code>

{| class="wikitable"
! Часть !! Описание
|-
| код || Команда, с которой сняты очки. Должна быть одной из двух команд матча N.
|-
| очки || Сколько очков снято: положительное число, можно дробное (<code>1,5</code>).
|-
| причина || Необязательно. Пишется как продолжение фразы: «за неявку на матч», «по решению КДК». Точка в конце не нужна. Можно использовать ссылки и «;».
|}
Для второго снятия в том же матче (например, с обеих команд) используется <code>matchN_deduction2</code>, и так далее до <code>matchN_deduction5</code>.

<pre>
| match7 = 4;2;ЦСК;СПА;1:1
| match7_deduction = СПА;3;за участие в матче дисквалифицированного игрока
</pre>

Результат:
* в итоговой таблице очки команды уменьшены, у названия стоит сноска вида [a], а при наведении на очки видна подсказка «Снято 3 очка»;
* под таблицей появляется блок «Примечания» с текстом ''С команды «Спартак» снято 3 очка в 4-м туре (матч «ЦСКА» — «Спартак») за участие в матче дисквалифицированного игрока.'' Номер тура упоминается, если он указан в матче;
* в таблице положения по турам очки снимаются начиная с этого тура, а в ячейке этого тура стоит та же сноска.

Сноски обозначаются буквами a, b, c… сверху вниз по итоговой таблице. Снятие действует независимо от того, сыгран ли матч, и не влияет на критерий <code>личные</code>.

== Оформление ==
{| class="wikitable"
! Параметр !! Описание
|-
| <code>heading_level</code> || Уровень заголовков «Результаты» и «Положение команд по турам»: от 2 до 6, по умолчанию 3 (<code><nowiki>=== Результаты ===</nowiki></code>). При значении <code>2</code> — <code><nowiki>== Результаты ==</nowiki></code>.
|-
| <code>id</code> || Префикс якорей для сносок. По умолчанию вычисляется по списку команд, поэтому обычно его указывать не нужно. Задайте разные <code>id</code>, если на одной странице две таблицы с одинаковым списком команд и со снятием очков. Лучше использовать латиницу, цифры и дефис.
|}

CSS-классы, которые выводит модуль:
{| class="wikitable"
! Класс !! Где используется
|-
| <code>football-tables</code> || Общий блок вокруг всех таблиц
|-
| <code>football-standings</code>, <code>football-results</code>, <code>football-progress</code> || Итоговая таблица, шахматка, таблица по турам
|-
| <code>football-info</code> || Строка критериев и блок примечаний
|-
| <code>football-notes</code> || Блок примечаний
|-
| <code>football-note-ref</code> || Сноска о снятии очков
|-
| <code>football-deduction</code> || Ячейка таблицы по турам, в которой сняты очки
|-
| <code>football-cards</code> || Ячейки столбцов карточек
|-
| <code>football-card</code>, <code>football-card-yellow</code>, <code>football-card-yellowred</code>, <code>football-card-red</code> || Значки карточек в заголовке
|-
| <code>highlight</code> и класс зоны || Строки цветовых зон и выделенные ячейки таблицы по турам
|-
| <code>ui green</code>, <code>ui yellow</code>, <code>ui red</code> || Результаты в шахматке
|-
| <code>football-corner</code>, <code>football-team-header</code>, <code>football-diagonal</code> || Угловая ячейка, названия команд и диагональ шахматки
|}

Цвета зон и результатов модуль не задаёт — они берутся из стилей вики. Если таких стилей ещё нет, их можно добавить в [[MediaWiki:Common.css]], например:
<pre>
.football-tables .highlight.green { background-color: #bbf3bb; }
.football-tables .highlight.blue { background-color: #bbebff; }
.football-tables .highlight.red { background-color: #ffbbbb; }
.football-results td.ui.green { background-color: #bbf3bb; }
.football-results td.ui.yellow { background-color: #ffffbb; }
.football-results td.ui.red { background-color: #ffbbbb; }
.football-progress td.football-deduction { font-weight: bold; }
</pre>

== Сообщения об ошибках ==
При ошибке во входных данных модуль вместо таблиц выводит сообщение, начинающееся со слова «Ошибка»:

{| class="wikitable"
! Сообщение !! Что исправить
|-
| не указан параметр ''teams'' || Добавьте список команд.
|-
| команда с кодом … указана более одного раза || Уберите повтор из <code>teams</code>.
|-
| матч N имеет неправильный формат || В <code>matchN</code> меньше трёх частей через «;».
|-
| в матче N неизвестная команда … || Код не входит в <code>teams</code>. Проверьте написание, в том числе не попали ли латинские буквы вместо кириллических.
|-
| параметр ''matchN_yellow'' имеет неправильный формат … || Карточки в матче записываются как <code>число:число</code> (то же для <code>matchN_yellowred</code> и <code>matchN_red</code>).
|-
| в параметре ''matchN_deduction'' должна быть указана команда матча … || Код команды должен совпадать с хозяевами или гостями матча N.
|-
| в параметре ''matchN_deduction'' не указано, сколько очков снято || Вторая часть должна быть ненулевым числом.
|-
| параметр ''yellow_КОД'' должен быть целым неотрицательным числом … || Исправьте итог карточек команды (то же для <code>yellowred_КОД</code> и <code>red_КОД</code>).
|}
Нераспознанный счёт работу модуля не останавливает: такой матч не учитывается, а в шахматке на его месте видно «ошибка: …».

== Пример ==
Четыре команды, шесть туров, карточки, снятие очков, цветовые зоны и таблица положения по турам. Без снятия очков первое место занял бы «Спартак».

<pre>
{{#invoke:Турнирная таблица|main
| teams = СПА;ЦСК;ЗЕН;ЛОК
| name_СПА = Спартак
| name_ЦСК = ЦСКА
| name_ЗЕН = Зенит
| name_ЛОК = Локомотив

| match1 = 1;1;СПА;ЦСК;2:1
| match2 = 1;1;ЗЕН;ЛОК;1:1
| match3 = 2;1;ЦСК;ЗЕН;0:2
| match4 = 2;1;ЛОК;СПА;1:3
| match5 = 3;1;СПА;ЗЕН;1:1
| match6 = 3;1;ЦСК;ЛОК;2:0
| match7 = 4;2;ЦСК;СПА;1:1
| match8 = 4;2;ЛОК;ЗЕН;0:1
| match9 = 5;2;ЗЕН;ЦСК;3:1
| match10 = 5;2;СПА;ЛОК;2:2
| match11 = 6;2;ЗЕН;СПА;0:2
| match12 = 6;2;ЛОК;ЦСК;перенесён

| match1_yellow = 2:3
| match1_yellowred = 0:1
| match4_yellow = 3:1
| match7_yellow = 1:2
| match7_red = 1:0
| match9_yellow = 2:2
| match11_yellow = 1:3
| match11_yellowred = 1:0

| match7_deduction = СПА;3;за участие в матче дисквалифицированного игрока

| highlight1 = 1;1;green;Выход в финальный турнир
| highlight2 = 4;1;red;Выбывание

| show_progress = yes
| progress_highlight1 = 1;green
| progress_highlight2 = 4;red
}}
</pre>

Результат:

{{#invoke:{{ROOTPAGENAME}}|main
| teams = СПА;ЦСК;ЗЕН;ЛОК
| name_СПА = Спартак
| name_ЦСК = ЦСКА
| name_ЗЕН = Зенит
| name_ЛОК = Локомотив

| match1 = 1;1;СПА;ЦСК;2:1
| match2 = 1;1;ЗЕН;ЛОК;1:1
| match3 = 2;1;ЦСК;ЗЕН;0:2
| match4 = 2;1;ЛОК;СПА;1:3
| match5 = 3;1;СПА;ЗЕН;1:1
| match6 = 3;1;ЦСК;ЛОК;2:0
| match7 = 4;2;ЦСК;СПА;1:1
| match8 = 4;2;ЛОК;ЗЕН;0:1
| match9 = 5;2;ЗЕН;ЦСК;3:1
| match10 = 5;2;СПА;ЛОК;2:2
| match11 = 6;2;ЗЕН;СПА;0:2
| match12 = 6;2;ЛОК;ЦСК;перенесён

| match1_yellow = 2:3
| match1_yellowred = 0:1
| match4_yellow = 3:1
| match7_yellow = 1:2
| match7_red = 1:0
| match9_yellow = 2:2
| match11_yellow = 1:3
| match11_yellowred = 1:0

| match7_deduction = СПА;3;за участие в матче дисквалифицированного игрока

| highlight1 = 1;1;green;Выход в финальный турнир
| highlight2 = 4;1;red;Выбывание

| show_progress = yes
| progress_highlight1 = 1;green
| progress_highlight2 = 4;red
}}

Модуль:Football/doc - История изменений

Andrew в 14:14, 3 октября 2026