Moduł:Build bracket

 Dokumentacja modułu[zobacz] [edytuj] [historia] • [odśwież] • § podstrony

Użycie

Ten moduł jest przeznaczony do tworzenia i edytowania drabinek sportowych, których nie można utworzyć za pomocą Moduł:RoundN lub Moduł:Team bracket. Moduł może być używany na przykład gdy potrzeba dodać dodatkowe nagłówki (dla drabinek podwójnej eliminacji; mecze o 3., 5., 7. miejsce; itd.), pominąć pojedyncze mecze. Składnia jest nieco bardziej skomplikowana niż w przypadku wyżej wymienionych modułów, ale prostsza niż użycie standardowego kodu wikitable.

{{#invoke:Build bracket|main
| rounds =

| col1-headers = 
| col1-matches = 

| col2-headers = 
| col2-matches = 

...

| col1-col2-paths = 
| col2-col3-paths = 

...
}}

Opis parametrów

Parameter	Opis	Domyślny
rounds	Liczba rund (kolumn)	1
autocol	Wpisz yes, aby automatycznie ustawić maksymalną liczbę rund do wyświetlenia na podstawie wpisanych danych	no
rows	Ręczne ustawianie liczby wierszy	Automatic
teams-per-match	Wprowadź liczbę drużyn w każdym meczu. Użyj colm-teams-per-match aby ustawić liczbę meczów w poszczególnych kolumnach m	2
colm-headers	(opcjonalnie) Wprowadź numery wierszy, w których w kolumnie m mają być nagłówki. Wpisy należy oddzielić znakiem ,. Dozwolone są wartości półcałkowite.	Automatic
colm-matches	Wprowadź numery wierszy, w których mają się znaleźć pola (mecze) w kolumnie m. Domyślnie są to dwa wiersze (dwa zespoły). Oddziel wpisy znakiem ,. Dozwolone są wartości półcałkowite.
RDmh-hide	Wpisz yes aby ukryć nagłówek nr h i wszystkie pola pod nim w kolumnie m, chyba że którykolwiek z tych wpisów nie jest pusty. Przydatne w przypadku meczów pocieszenia.
colm-colm+1-paths	Wprowadź numery wierszy początkowych i końcowych, oddzielone znakiem -, w których ścieżka ma połączyć kolumnę m z m+1. Oddziel wpisy znakiem ,. Dozwolone są wartości półcałkowite.
colm-colm+1-cross	Wprowadź numer wiersza, w którym ścieżki z kolumny m do m +1 mają się przeciąć
RDm-altname	Alternatywna nazwa dla RDm (np. jeśli wpiszesz RD1-altname=pierwsza, to później pierwsza-team1 może być używany zamiast RD1-team1). Stosuj RDmh-altname dla komórek pod nagłówkiem mh
text-altname	Alternatywna nazwa dla RDm-textk (np. jeśli wpiszesz text-altname=szczegóły to RDm-szczegóły1 może być używany zamiast RDm-text1)
maxround	Ostatnia rudna do wyświetlenia. Parametr ten należy pominąć, chyba, że jest on mniejszy od wartości domyślnej ustawionej przez rounds.
minround	Pierwsza runda do wyświetlenia	1
height	Wpisz żądaną wysokość pól. Tworzy pionowy pasek przewijania. Wpisz liczbę z jednostkami (np. 30em lub 480px).
col-spacing	Wielkość przestrzeni pomiędzy rundami. Wpisz samą liczbę (np. 10 dla 10px).	5
seed-width	Szerokość komórek dla rozstawienia. Wpisanie samej liczby oznacza jednostkę px (np. 25 to 25px, a 2em to 2em)	25
team-width	Szerokość komórki dla nazwy zespołu. Wpisanie samej liczby oznacza jednostkę px (np. 200 to 200px, a 15em to 15em)	150
score-width	Szerokość komórki dla wyniku. Wpisanie samej liczby oznacza jednostkę px (np. 25 to 25px, a 2em to 2em)	25
agg-width	Szerokość komórki dla wyników zbiorczych. score-width zmieni szerokość tej komórki, chyba, że ten parametr zostanie użyty. Wpisanie samej liczby oznacza jednostkę px (np. 25 to 25px, a 2em to 2em)	25
seeds	Wpisz no, żeby pominąć rozstawienie we wszystkich meczach. Wpisz yes, żeby pokazać rozstawienie we wszystkich meczach.
legs	Liczba meczów w każdej rundzie. Użyj RDm-legs, żeby osobno ustawić liczbę w kolumnach (rundach). Użyj RDm-legsk, żeby indywidualnie ustawić liczbę meczów dla drużyny k w rundzie m.	1
autolegs	Wpisz yes, żeby automatycznie generować komórki punktowe dla każdego zespołu. Jeśli legs albo RDm-legs jest używany, autolegs będzie automatycznie ustawiony na no	no
byes	Wpisz yes, żeby ukryć wszystkie puste komórki zespołu. Alternatywnie, dla wartości m, puste komórki zespołu w rundach od 1 do m zostaną ukryte. Użyj RDm-byes tylko do pól w kolumnie m. Użyj RDmh-byes tylko do pól w nagłówku h i tylko w kolumnie m.	no
show-bye-paths	Wpisz yes, żeby zastąpić ścieżką każde ukryte pole zespołu przez byes.	no
aggregate	Wpisz sets lub legs, żeby zsumować wygrane i dodać je na koniec wyników. Ustaw score aby zsumować wyniki z każdego pojedynku i dodać je na koniec wyników. Ustaw yes, aby włączyć sufiks -agg, ale bez automatycznego obliczania. Każdą automatycznie obliczoną wartość można zastąpić, ustawiając ją ręcznie za pomocą sufiksu -agg wyniku.	no
boldwinner	Wpisz na high, aby automatycznie pogrubić rozstawienie/drużynę/wynik dla wyższego wyniku w każdym meczu. Ustaw na low dla najniższego wyniku. Ustaw na aggregate, aby pogrubić tylko wyższy wynik łączny. Ustaw na aggregate-low aby pogrubić tylko niższy wynik łączny.	no
shift	Przesuwa w pionie wszystkie wpisy o wprowadzoną liczbę. Użyj RDm-shift dla wybranych kolumn.	0
RDm, RDmh	Nagłówek tekstowy w kolumnie m (np. RD1 lub RD1a dla pierwszego nagłówka, RD1b dla drugiego nagłówka w kolumnie 1).
RDm-seedk	Rozstawienie zespołu nr k w kolumnie m. Alternatywnie, użyj RDmh-seedk dla zespołu nr k poniżej nagłówka mh.
RDm-teamk	Nazwa zespołu nr k w kolumnie m. Alternatywnie, użyj RDmh-teamk dla zespołu nr k poniżej nagłówka mh.
RDm-scorek	Wynik zespołu nr k w kolumnie m. Alternatywnie, użyj RDmh-scorek dla zespołu nr k poniżej nagłówka mh. Dołącz przyrostek -l dla liczby meczów (ilość l) lub -agg dla pola z sumą wyników.
RDm-textk	Tekst powyżej meczu nr k w kolumnie m. Alternatywnie, użyj RDmh-textk dla meczu nr k poniżej nagłówka mh.
RDm-groupk	Tekst grupy nr k w kolumnie m. Tekst grupy pojawi się po lewej stronie miejsca spotkania ścieżek.
RD-shade	Kolor tła (w formacie hex, np. #ABCDEF) wszystkich nagłówków. Użyj RDm-shade lub RDmh-shade dla każdego nagłówka osobno.	#F2F2F2
RDm-RD(m+1)-path	Wpisz no lub 0 by pominąć ścieżki od rundy m do rundy m+1.	yes
paramstyle	Wpisz numbered, żeby zmienić styl nazw parametrów RDm-textk, RDm-seedk, RDm-teamk i RDm-scorek na zapis numeryczny (1, 2...). Dodaj seeds=yes, żeby dodać pola rozstawienia.	indexed

Hierarchia parametrów

Jeśli w jednej kolumnie znajduje się wiele nagłówków, do wartości komórki można przypisać więcej niż jeden parametr. Na przykład w poniższej drabince można użyć zarówno |RD1-team3=, jak i |RD1b-team1=, aby przypisać trzecią drużynę w pierwszej kolumnie. Domyślnie wpisy z prefiksami podnagłówków zastąpią te bez nich. W poniższym przykładzie RD1b-team1 zastąpi każdą wartość ustawioną przez RD1-team3.

	Wyższa runda
	Niższa runda
	RD1-team3 lub RD1b-team1

Tworzenie ścieżek

Ścieżki tworzy się poprzez zapis a-b, gdzie a jest łączonym meczem z pierwszej kolumny, a b jest łączonym meczem z drugiej kolumny. Kody ścieżek można grupować; na przykład: (a,b)-c oznacza to samo co a-c, b-c. Żeby zmienić kolor ścieżki, dodaj :kolor na końcu kodu ścieżki, np. 3-5:red. Może być użyty tylko jeden kolor w ścieżce.

Kod	Wywołanie
1-3
(1,5)-3
3-1,3-5:red

Przykład

Prosta drabinka dla 4 zespołów

{{#invoke:Build bracket|main
| rounds=2

| col1-headers = 1
| col2-headers = 1

| col1-matches = 3,7
| col2-matches = 5

| col1-col2-paths = (3,7)-5

<!-- Domyślnie -->
| RD2 = Grand Final

| RD1-seed1 = 1
| RD1-seed3 = 2
}}

	Semifinals					Grand Final
	1
	2

3 ścieżkowa drabinka

{{#invoke:Build bracket|main
| rounds=2
| teams-per-match = 3

| col1-headers = 1
| col2-headers = 1

| col1-matches = 3,7,11
| col2-matches = 7

| col1-col2-paths = (3,7,11)-7
}}

	Semifinals					Final

Drabinka z podwójną eliminacją

{{#invoke:Build bracket|main
| rounds=4

| col1-headers = 1,7
| col2-headers = 1,7
| col3-headers = 7
| col4-headers = 1

| col1-matches = 4,11
| col2-matches = 3,10
| col3-matches = 9
| col4-matches = 6

| col1-col2-paths = 4-3, 11-10
| col2-col3-paths = 3-3, 10-9
| col3-col4-paths = (3,9)-6

<!-- Defaults -->
| RD1 = Górna runda
| RD2 = Górny finał
| RD3b = Dolny finał
}}

Górna runda

Górny finał

Final

Lower round 1

Lower round 2

Dolny finał

Przecięcie ścieżek

{{#invoke:Build bracket|main
| rounds=2

| col1-matches = 3,7
| col2-matches = 3,7

| col1-col2-paths = 3-7, 7-3
| col1-col2-cross = 5
}}

	Semifinals						Final

Tekst

{{#invoke:Build bracket|main
| rounds=2
| col1-matches = 3,6
| col2-matches = 4.5
| col1-col2-paths = (3,6)-4.5

| RD1-text1 = Text 1
| RD1-text2 = Text 2
| RD2-text1 = Text 3
}}

	Semifinals					Final
	Text 1
						Text 3
	Text 2

Grupy

{{#invoke:Build bracket|main
| rounds=3
| col1-matches = 3,6,9,12
| col2-matches = 4.5,10.5
| col3-matches = 7.5

| col1-col2-paths = (3,6)-4.5, (9,12)-10.5
| col2-col3-paths = (4.5,10.5)-7.5

| RD1-group1 = Group 1
| RD1-group2 = Group 2
| RD2-group1 = Group 3
}}

Quarterfinals

Semifinals

Final

Group 1

Group 3

Group 2

Liczba meczów i suma

{{#invoke:Build bracket|main
| rounds=3
| legs = 2
| RD1-legs = 3
| aggregate = y

| col1-matches = 3,6,9,12
| col2-matches = 4.5,10.5
| col3-matches = 7.5

| col1-col2-paths = (3,6)-4.5, (9,12)-10.5
| col2-col3-paths = (4.5,10.5)-7.5
}}

Quarterfinals

Semifinals

Final

Pominięcie pustych meczów

{{#invoke:Build bracket|main
| rounds=3
| RD1-byes = y

| col1-matches = 3,6,9,12
| col2-matches = 4.5,10.5
| col3-matches = 7.5

| col1-col2-paths = (3,6)-4.5, (9,12)-10.5
| col2-col3-paths = (4.5,10.5)-7.5

| RD1-team1 = Drużyna 1
| RD1-team2 = Drużyna 2
}}

Quarterfinals

Semifinals

Final

Drużyna 1

Drużyna 2

Numerowane parametry

{{#invoke:Build bracket|main
| rounds=2
| col1-matches = 3,7
| col2-matches = 5
| col1-col2-paths = (3,7)-5

| paramstyle = numbered
| seeds = yes

| Tekst 1 | 1 | Zespół 1 | 5 | 4 | Zespół 2 | 11
| Tekst 2 | 2 | Zespół 3 | 6 | 3 | Zespół 4 | 3

| Tekst 3 | 4 | Zespół 2 | 2 | 2 | Zespół 3 | 1 
}}

	Semifinals					Final
	Tekst 1
	1	Zespół 1	5
	4	Zespół 2	11			Tekst 3
						4	Zespół 2	2
	Tekst 2					2	Zespół 3	1
	2	Zespół 3	6
	3	Zespół 4	3

Pogrubiony zwycięzca

{{#invoke:Build bracket|main
| rounds=2
| legs = 3
| boldwinner=y
| col1-matches = 3,7
| col2-matches = 5
| col1-col2-paths = (3,7)-5

| RD1-seed1 = 1 | RD1-team1 = Zespół 1 | RD1-score1-1 = 5  | RD1-score1-2 = 12 | RD1-score1-3 = 15
| RD1-seed2 = 4 | RD1-team2 = Zespół 2 | RD1-score2-1 = 11 | RD1-score2-2 = 10 | RD1-score2-3 = 4

| RD1-seed3 = 2 | RD1-team3 = Zespół 3 | RD1-score3-1 = 6  | RD1-score3-2 = 13 | RD1-score3-3 = –
| RD1-seed4 = 3 | RD1-team4 = Zespół 4 | RD1-score4-1 = 3  | RD1-score4-2 = 2  | RD1-score4-3 = –

| RD2-seed1 = 4 | RD2-team1 = Zespół 2 | RD2-score1-1 = 2  | RD2-score1-2 = 2  | RD2-score1-3 = 5
| RD2-seed2 = 2 | RD2-team2 = Zespół 3 | RD2-score2-1 = 1  | RD2-score2-2 = 7  | RD2-score2-3 = 2
}}

	Semifinals							Final
	1	Zespół 1	5	12	15
	4	Zespół 2	11	10	4
								4	Zespół 2	2	2	5
								2	Zespół 3	1	7	2
	2	Zespół 3	6	13	–
	3	Zespół 4	3	2	–

Błędy

Błędy należy zgłaszać na stronie Wikipedia:Kawiarenka/Kwestie techniczne.

Zobacz też

• Moduł:Team bracket

Powyższy opis jest dołączany ze strony Moduł:Build bracket/opis. (edytuj | historia)

Zobacz wszystkie podstrony tej strony.

local p = {}

-- Submodules
local Helpers = require("Module:Build bracket/Helpers")
local Config = require("Module:Build bracket/Config")
local Params = require("Module:Build bracket/Params")
local StateChecks = require("Module:Build bracket/StateChecks")
local Logic = require("Module:Build bracket/Logic")
local Paths = require("Module:Build bracket/Paths")
local Render = require("Module:Build bracket/Render")
-- local Deprecations = require('Module:Build bracket/Deprecations')

function p.main(frame)
    -- Shared mutable state passed among submodules
    local state = {
        headerindex = {},
        rlegs = {},
        maxlegs = {},
        hascross = {},
        crossCell = {},
        pathCell = {},
        skipPath = {},
        hide = {},
        byes = {},
        teamsPerMatch = {},
        matchgroup = {},
        maxtpm = 0
    }
    local config = {}

    -- 1) Parse args & set config (also installs arg accessors on Helpers)
    Config.init(frame, state, config, Helpers)

    -- 2) Bind StateChecks (used by Params/Logic/Paths/Render)
    StateChecks.bind(state, config, Helpers)

    -- 3) Build entries skeleton from args (headers/teams/text/lines/groups)
    Params.buildSkeleton(state, config, Helpers, StateChecks)

    -- 4) Discover indices/byes/hide across the skeleton
    Params.scanStructure(state, config, Helpers, StateChecks)

    -- 5) assign per-entry params
    Params.assign(state, config, Helpers, StateChecks)

    -- 5.5) apply minround slicing (reindex to start at 1)
    Params.sliceForMinround(state, config)

    -- 6) Logic passes (max legs, grouping, aggregates, bolding)
    Logic.updateMaxLegs(state, config, Helpers)
    Logic.matchGroups(state, config)
    Logic.computeAggregate(state, config, Helpers, StateChecks)
    Logic.boldWinner(state, config, Helpers, StateChecks)

    -- 7) paths + derive groups from paths
    Paths.build(state, config, Helpers, StateChecks)
    Paths.attachGroups(state, config, Helpers, StateChecks)

    -- (Harmless guard if user passed odd ranges)
    if (tonumber(config.c) or 1) < (tonumber(config.minc) or 1) then
        config.c = config.minc
    end

    -- 8) Render HTML table
    local html = Render.buildTable(frame, state, config, Helpers, StateChecks)
    return tostring(html)
end

-- Exposed for tests/scripts that invoke without a frame
p._main = p.main

return p