Andrew: Новая страница: «'''Кубковая сетка''' — шаблон для турнирной сетки кубкового (олимпийского) турнира: плей-офф с соединительными линиями, необязательный матч за третье место и сводная таблица матчей под сеткой. Логика — в Модуль:Кубковая сетка, оформление — в Шаблон:К...»

2026-09-23T09:15:14Z

Новая страница: «'''Кубковая сетка''' — шаблон для турнирной сетки кубкового (олимпийского) турнира: плей-офф с соединительными линиями, необязательный матч за третье место и сводная таблица матчей под сеткой. Логика — в Модуль:Кубковая сетка, оформление — в Шаблон:К...»

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

'''Кубковая сетка''' — шаблон для турнирной сетки кубкового (олимпийского) турнира: плей-офф с соединительными линиями, необязательный матч за третье место и сводная таблица матчей под сеткой. Логика — в [[Модуль:Кубковая сетка]], оформление — в [[Шаблон:Кубковая сетка/styles.css]] (TemplateStyles). Требуются расширения Scribunto, ParserFunctions и TemplateStyles.

Главные свойства:
* любое число этапов (по умолчанию до 7, то есть с 1/64 финала) — определяется автоматически по номерам матчей;
* матчи добавляются по одному, в любом порядке; незаполненные слоты остаются пустыми рамками;
* победители сами переходят в следующий этап, проигравшие полуфиналов — в матч за третье место;
* сводная таблица строится только из матчей с данными;
* незнакомые шаблону поля не ломают вызов — их можно использовать при доработке модуля.

== Быстрый старт ==
<pre>
{{Кубковая сетка
| s1m1_team1 = Франция | s1m1_score1 = 1
| s1m1_team2 = Бельгия | s1m1_score2 = 0
| s1m2_team1 = Хорватия | s1m2_score1 = 2
| s1m2_team2 = Англия | s1m2_score2 = 1 | s1m2_aet = да
| s2m1_score1 = 4 | s2m1_score2 = 2 | s2m1_date = 2018-07-15 | s2m1_city = [[Москва]]
}}
</pre>
Получится сетка из двух этапов («Полуфиналы», «Финал»); команды финала подставятся из полуфиналов, под сеткой появится сводная таблица.

== Нумерация матчей ==
Каждое поле матча записывается как <code>s''K''m''J''_''поле''</code>: '''K''' — номер этапа (1 — первый этап сетки), '''J''' — номер матча в этапе сверху вниз.
<pre>
этап 1 этап 2 этап 3
s1m1 ──┐
├── s2m1 ──┐
s1m2 ──┘ │
├── s3m1 (финал)
s1m3 ──┐ │
├── s2m2 ──┘
s1m4 ──┘
</pre>
* Матчи ''2J−1'' и ''2J'' этапа ''K'' сходятся в матч ''J'' этапа ''K+1'': победитель верхнего становится '''командой 1''', нижнего — '''командой 2'''.
* Число этапов ''N'' — наименьшее, при котором помещаются все заданные матчи (на этапе ''K'' с ''M'' матчами нужно ''N'' ≥ ''K'' + ⌈log₂''M''⌉). Его можно задать явно параметром <code>stages</code>.
* Названия этапов по умолчанию считаются от финала: «Финал», «Полуфиналы», «Четвертьфиналы», «1/8 финала», «1/16 финала»… Поэтому сетка «с 1/8» и сетка «с 1/4» подписываются правильно без настройки.
* Свободный проход (bye) — скрыть слот параметром <code>s''K''m''J''_hide = да</code> и указать команду сразу в матче следующего этапа.

== Глобальные параметры ==
{| class="wikitable"
! Параметр !! Назначение !! Значения !! По умолчанию
|-
| <code>title</code> || Заголовок над сеткой || текст / викитекст || —
|-
| <code>stages</code> || Число этапов (если нужно больше, чем следует из номеров матчей, например чтобы показать пустую сетку) || 1…7 || авто
|-
| <code>bracket</code> || Показывать сетку || да / нет || да
|-
| <code>summary</code> || Показывать сводную таблицу || да / нет || да
|-
| <code>summary_title</code> || Подпись (caption) сводной таблицы || текст || —
|-
| <code>summary_stage</code> || Вывести в таблице только перечисленные разделы: номера этапов и/или ключи доп. матчей || <code>1</code>, <code>2,3</code>, <code>3,third,4</code> || все
|-
| <code>summary_sort</code> || Сортировать матчи раздела по дате и времени (если у всех дата в формате ГГГГ-ММ-ДД); «нет» — порядок сетки || да / нет || да
|-
| <code>autofill</code> || Подставлять победителей в следующий этап и проигравших полуфиналов в матч за 3-е место || да / нет || да
|-
| <code>hide_empty</code> || Скрывать совсем пустые слоты (без команд, счёта, даты) || да / нет || нет
|-
| <code>third</code> || Матч за третье место: «да» — показать всегда, «нет» — скрыть всегда, пусто — показать, если есть данные <code>third_*</code> || да / нет || авто
|-
| <code>flagsize</code> || Размер флагов-файлов || <code>23x15px</code>, <code>20px</code> || 23x15px
|-
| <code>flagtemplate</code> || Шаблон флагов: короткий код флага передаётся ему первым параметром || <code>Флагификация</code> || —
|-
| <code>theme</code> || Тема оформления: класс <code>.cb--theme-''имя''</code> и страница <code>Шаблон:Кубковая сетка/theme-''имя''.css</code>, если есть || <code>compact</code> || —
|-
| <code>class</code> || Дополнительный CSS-класс корневого блока || <code>my-cup</code> || —
|-
| <code>styles</code> || Своя таблица стилей (TemplateStyles), подключается после основных || <code>Шаблон:Кубок России/styles.css</code> || —
|-
| <code>data</code> || Взять параметры из <code>Модуль:Кубковая сетка/данные/''имя''</code>; параметры вызова переопределяют их || <code>ЧМ-2018</code> || —
|-
| <code>debug</code> || Показать список нераспознанных параметров (опечатки) || да / нет || нет
|}
Логические параметры понимают <code>да/нет</code>, <code>yes/no</code>, <code>1/0</code>, <code>вкл/выкл</code>.

== Параметры этапа ==
{| class="wikitable"
! Параметр !! Назначение !! Пример
|-
| <code>s''K''_name</code> || Название этапа (в сетке и в сводке) || <code>s1_name = 1/4 финала</code>
|-
| <code>s''K''_summary</code> || «нет» — не выводить этап в сводной таблице || <code>s1_summary = нет</code>
|-
| <code>s''K''_class</code> || CSS-класс заголовка и матчей этапа || <code>s4_class = cb-final</code>
|}

== Параметры матча ==
Все поля пишутся с префиксом <code>s''K''m''J''_</code> (или <code>third_</code> для матча за третье место). Любое поле необязательно.
{| class="wikitable"
! Поле !! Назначение !! Пример значения
|-
| <code>team1</code>, <code>team2</code> || Команды: викитекст или код из реестра (см. ниже). Пусто — подставится из предыдущего этапа || <code>FRA</code>, <code><nowiki>[[Сборная Франции по футболу|Франция]]</nowiki></code>
|-
| <code>flag1</code>, <code>flag2</code> || Флаг/эмблема: имя файла, код из реестра, готовый викитекст или код для <code>flagtemplate</code>. Если не задан, берётся флаг команды из реестра || <code>Flag of France.svg</code>, <code>FRA</code>
|-
| <code>score1</code>, <code>score2</code> || Счёт (с учётом доп. времени). Можно и нечисловой — тогда укажите <code>winner</code> || <code>2</code>, <code>+</code>
|-
| <code>pen1</code>, <code>pen2</code> || Серия пенальти; в сетке выводится как «1 (4)», у победителя — приписка «(пен.)» || <code>4</code>
|-
| <code>aet</code> || Матч завершился в дополнительное время: приписка «(доп. вр.)» у победителя и в сводке || <code>да</code>
|-
| <code>winner</code> || Победитель явно (перекрывает расчёт по счёту и пенальти): для техн. побед, жребия, неполных данных || <code>1</code>, <code>2</code>
|-
| <code>date</code> || Дата: ГГГГ-ММ-ДД превращается в «30 июня» (сетка) и «30 июня 2018» (сводка); любой другой текст — как есть || <code>2018-06-30</code>
|-
| <code>time</code> || Время начала (только сводка) || <code>17:00 MSK (UTC+3)</code>
|-
| <code>city</code> || Город (подпись в сетке и сводка) || <code><nowiki>[[Казань]]</nowiki></code>
|-
| <code>stadium</code> || Стадион (сводка; в сетку — если нет города) || <code><nowiki>«[[Казань Арена]]»</nowiki></code>
|-
| <code>place</code> || Место для подписи в сетке, если нужно иначе, чем в сводке || <code><nowiki>[[Москва]] ([[Лужники (стадион)|Лужники]])</nowiki></code>
|-
| <code>caption</code> || Подпись над матчем в сетке целиком (заменяет «дата — место») || <code>Переигровка</code>
|-
| <code>attendance</code> || Зрители; число форматируется по правилам языка вики || <code>42873</code>
|-
| <code>referee</code> || Главный судья || <code><nowiki>[[Фагани, Алиреза|Алиреза Фагани]]</nowiki></code>
|-
| <code>referee_flag</code> || Флаг судьи (как <code>flag1</code>) || <code>IRN</code>
|-
| <code>goals1</code>, <code>goals2</code> || Авторы голов (сводка), строки через <code><nowiki><br></nowiki></code> || <code><nowiki>Павар 57′<br>Мбаппе 64′, 68′</nowiki></code>
|-
| <code>shootout1</code>, <code>shootout2</code> || Бьющие серии пенальти — отдельная строка «Пенальти» в сводке || <code><nowiki>Иньеста ✔<br>Коке ✘</nowiki></code>
|-
| <code>report</code> || Отчёт о матче: URL превращается в ссылку «(отчёт)», викитекст — как есть || <code><nowiki>https://www.fifa.com/…</nowiki></code>
|-
| <code>status</code> || Статус: <code>scheduled</code>/<code>запланирован</code>, <code>live</code>/<code>идёт</code>, <code>finished</code>/<code>завершён</code>, <code>postponed</code>/<code>перенесён</code>, <code>cancelled</code>/<code>отменён</code>. По умолчанию «завершён», если есть счёт, иначе «запланирован». Даёт класс <code>cb-status-''…''</code> и подпись в сводке || <code>live</code>
|-
| <code>home</code> || Хозяин поля — класс <code>cb-team--home</code> у строки команды (маркер оформляется в CSS) || <code>1</code>
|-
| <code>note</code> || Примечание курсивом в последней колонке сводки || <code>Матч перенесён из-за погоды</code>
|-
| <code>summary</code> || Принудительно включить/исключить матч из сводки || <code>да</code> / <code>нет</code>
|-
| <code>hide</code> || Скрыть слот (свободный проход): место сохраняется, линии не рисуются || <code>да</code>
|-
| <code>class</code> || CSS-класс матча (и строки сводки) || <code>cb-derby</code>
|}
Русские синонимы полей: <code>команда1/2</code>, <code>флаг1/2</code>, <code>счёт1/2</code> (<code>счет1/2</code>), <code>пен1/2</code>, <code>дата</code>, <code>время</code>, <code>город</code>, <code>стадион</code>, <code>зрители</code>, <code>судья</code>, <code>отчёт</code>, <code>статус</code>, <code>победитель</code>, <code>доп</code>; для этапа — <code>название</code>. Например, <code>s1m1_счёт1 = 2</code> равносильно <code>s1m1_score1 = 2</code>.

== Матч за третье место ==
Поля те же, что у матча, с префиксом <code>third_</code>, плюс:
{| class="wikitable"
! Параметр !! Назначение !! Пример
|-
| <code>third_title</code> || Название блока и раздела сводки || <code>Матч за бронзу</code> (по умолчанию «Матч за третье место»)
|-
| <code>third_position</code> || <code>inside</code> — в колонке финала на уровне нижнего полуфинала (как в классических сетках; только при 4 и более этапах); <code>below</code> — под сеткой || по умолчанию inside при ≥ 4 этапах, иначе below
|}
Блок появляется, если задано хотя бы одно поле <code>third_*</code> (кроме title/position/class/hide/summary) или <code>third = да</code>; <code>third = нет</code> скрывает его полностью, вместе с разделом сводки. Команды, если не заданы, подставляются из проигравших полуфиналов.

== Реестр команд и флагов ==
Чтобы не повторять ссылку и флаг в каждом матче, задайте их один раз по коду:
<pre>
| team_FRA = [[Сборная Франции по футболу|Франция]] | flag_FRA = Flag of France.svg
| team_CRO = [[Сборная Хорватии по футболу|Хорватия]] | flag_CRO = Flag of Croatia.svg
| s1m1_team1 = FRA | s1m1_team2 = CRO | s1m1_referee_flag = IRN
</pre>
Коды — любые латинские буквы/цифры. Флаг без команды (<code>flag_IRN</code>) удобен для флагов судей. Для шаблона флагов задайте <code>flagtemplate</code> — тогда код без записи в реестре передаётся этому шаблону.

== Сводная таблица ==
* Разделы идут по этапам; матч за третье место — перед финалом.
* Строка появляется, только если известны '''обе''' команды (явно или через автозаполнение) и есть хотя бы что-то из: счёт, дата, время, стадион, город. Поле <code>summary</code> матча перекрывает это правило.
* Раздел без строк не выводится; если строк нет вовсе — таблицы нет.
* Внутри раздела матчи сортируются по дате и времени (<code>summary_sort = нет</code> — порядок сетки).
* Колонки: дата/время · команда 1 и голы · счёт, доп. время, пенальти, отчёт, статус · команда 2 и голы · стадион, зрители, судья, примечание. Серия пенальти с бьющими — отдельной строкой.
* Разбить сводку по разделам статьи: один вызов с <code>summary = нет</code> для сетки и под каждым разделом — вызов с <code>bracket = нет | summary_stage = 1</code> и т. д. Чтобы не дублировать данные, храните их в модуле данных (<code>data=</code>).

== Оформление ==
* Основные стили — [[Шаблон:Кубковая сетка/styles.css]]; цвета тёмной темы — [[Шаблон:Кубковая сетка/tokens.css]] (подключается, если существует).
* Тема <code>theme=''имя''</code>: создайте <code>Шаблон:Кубковая сетка/theme-''имя''.css</code> с селекторами <code>.cb--theme-''имя'' …</code>. Пример — [[Шаблон:Кубковая сетка/theme-compact.css]].
* Основные классы: <code>.cb-head</code> (заголовок этапа), <code>.cb-item</code> (матч), <code>.cb-caption</code> (подпись), <code>.cb-team</code> (строка команды; модификаторы <code>--winner</code>, <code>--loser</code>, <code>--home</code>, <code>--tbd</code>, <code>--auto</code>), <code>.cb-name</code>, <code>.cb-score</code>, <code>.cb-conn</code> (линии), <code>.cb-extra--third</code>, <code>.cb-status-''статус''</code>, <code>table.cb-summary</code>.
* '''Важно:''' высота подписи (1.6em) и нижний отступ матча (0.4em) участвуют в расчёте положения линий. Меняете их — пересчитайте смещение по формуле из styles.css (раздел 3).

== Примеры ==
Полные примеры на данных чемпионата мира 2018 года (1/8 финала → финал с матчем за третье место; сетка с четвертьфинала без матча за третье место; турнир в процессе; нерегулярная сетка со свободными проходами) — на странице [[Шаблон:Кубковая сетка/Примеры]].

Минимальный пример с матчем за третье место:
<pre>
{{Кубковая сетка
| s1_name = 1/2 финала
| s1m1_team1 = Франция | s1m1_team2 = Бельгия | s1m1_score1 = 1 | s1m1_score2 = 0
| s1m2_team1 = Хорватия | s1m2_team2 = Англия | s1m2_score1 = 2 | s1m2_score2 = 1 | s1m2_aet = да
| s2m1_score1 = 4 | s2m1_score2 = 2
| third_score1 = 2 | third_score2 = 0 | third_date = 2018-07-14
}}
</pre>

== Ошибки и предупреждения ==
Под сеткой выводятся сообщения (класс <code>error</code>), если матч не помещается в сетку (номер слишком велик для числа этапов), <code>stages</code> вне диапазона или не загрузился модуль данных. С <code>debug = да</code> дополнительно перечисляются нераспознанные параметры.

Шаблон:Кубковая сетка/doc - История изменений