Modul:Sports series/doc

Ez a modul egy sportesemény mérkőzéseinek táblázatos megjelenítésére szolgál. Támogatja az egymérkőzéses és a többmérkőzéses variációkat is, korlátlan számú mérkőzésig. A modul a klub és a válogatott tornák mérkőzéseinek megjelenítésére is alkalmas. Alapvetően a labdarúgáshoz készült, de más sportágak mérkőzéseihez is használható.

Használata

A legegyszerűbb formához csak néhány paraméterre van szükség egy táblázat létrehozásához.

Nemzetközi klubtornák

A kétmérkőzéses (oda-visszavágós) rendszerű változathoz hét paraméterre van szükség, minden sorban. Ez tartalmazza a klubok nevét, a nemzeti szövetség országának nevét/kódját, az összesített eredményt és a két mérkőzés eredményét.

{{#invoke:Sports series|main
|első_klub|első_klub_tagországa|összesítés|második_klub|második_klub_tagországa|első_mérkőzés|második_mérkőzés
}}

Nemzeti klubtornák

A kétmérkőzéses (oda-visszavágós) rendszerű változathoz öt paraméterre van szükség, minden sorban. Ez tartalmazza a klubok nevét, az összesített eredményt és a két mérkőzés eredményét. A zászlót nem szükséges megjeleníteni.

{{#invoke:Sports series|main|flag=n
|első_klub|összesítés|második_klub|első_mérkőzés|második_mérkőzés
}}

Nemzetközi válogatottak

A kétmérkőzéses (oda-visszavágós) rendszerű változathoz öt paraméterre van szükség, minden sorban. Ez tartalmazza az országok neveit, az összesített eredményt és a két mérkőzés eredményét. Mivel a válogatottak sablonjai tartalmaznak zászlót is, ezért a flag=no beállítást kell használni.

{{#invoke:Sports series|main|flag=n
|első_válogatott|összesítés|második_válogatott|első_mérkőzés|második_mérkőzés
}}

Paraméterek listája

Minden paraméter opcionális.

Paramáter	Leírás	Típus
|type=	Meghatározza a megjelenítendő típust. Választható értékek: klub (alapértelmezés) vagy vál (férfi válogatott) vagy nvál (női válogatott).	Szöveg
|flag=	Meghatározza, hogy melyik zászlósablont használjuk. Az alapértelmezés klubok esetén a {{zászlóikon}}(?), a férfi válogatottak esetén az {{lr}}(?), női válogatottak esetén az {{lrn}}(?). Ha negatív értékre van állítva (pl. n, nem, no, 0), akkor nem jelennek meg a zászlók a |type=klub beállítás esetén. A |type=vál beállítás esetén az első válogatott az {{lr-j}}(?) sablonnal jelenik meg.	Szöveg
|legs=	Meghatározza a táblázatban megjelenő mérkőzések számát, és azt, hogy várhatóan hány paraméterre van szükség soronként. Az alapértelmezés 2. Ha negatív értékre van beállítva (pl. n, nem, no, 0), a táblázatban csak egy mérkőzés jelenik meg, középen, az összesített oszlop helyén. Az összesített oszlop fejléce "Eredmény"-re módosul.	Szám
|bold_winner=	Alapértelmezés szerint automatikusan beállítva. A kikapcsolásához negatív értéket kell beállítani (pl. n, nem, no, 0). A modul automatikusan vastagbetűsen jelöli a győztes csapatot: elsőként a zárójelben jelölt eredmény alapján (általában büntetőpárbaj eredményei), majd a normál eredmény alapján. Ha kétmérkőzéses párosítások esetén az összesítés egyenlő és nincs zárójeles adat, akkor az „idegenben szerzett gólok” szabály alapján állapítja meg a győztes csapatot, (kivéve, ha a |away_goals= használatával ez a funkció ki van kapcsolva). Minden más esetben, ha az adatok alapján nem lehet győztest meghatározni, akkor egyik csapat sem lesz vastagbetűsvel jelölve.	Szöveg
|color_winner=	Az alkalmazásához pozitív értéket kell megadni (pl. i, igen, y, yes, 1). A modul a automatikusan győztes csapat cella hátterét zöld (#BBF3BB) színűre változtatja. A győztes megállapítását lásd a „bold_winner” paraméter leírásánál. Ha ez a paraméter aktív az egymérkőzéses táblázatban, akkor a döntetlenek esetén az eredmény cella háttére sárga (#FFFFBB) színű lesz.	Szöveg
|matches_style=	Ha az értéke FBR egymérkőzéses táblázat esetén, akkor az eredmény cella háttérét a mérkőzés eredménye alapján színezi. A hazai győztes kék (#BBF3FF), a döntetlen sárga (#FFFFBB), az idegenbeli győztes piros (#FFBBBB) lesz. A táblázat alá jelmagyarázat is kerül a színekhez és a fejléc „Hazai” és „Vendég” szövegre változik (ilyenkor a |h_a= vagy |h_v= paramétert nem kell használni). Ez a funkció a Modul:Sports results színezésével azonos.	Szöveg
|solid_cell=	Pozitív érték esetén (pl. i, igen, y, yes, 1), azoknak a mérkőzéseknek a celláit, amelyben null érték van szürke (#BBBBBB) színűre változtatja.	Szöveg
|small_text=	Alapértelmezés szerint automatikusan beállítva. A kikapcsolásához negatív értéket kell beállítani (pl. n, nem, no, 0). A modul automatikusan kis betűs szöveggel jeleníti meg azoknak a mérkőzéseknek az eredménycelláit, amelyeknél még nincs eredmény. Ennek célja, hogy lehetővé tegye a jövőbeli mérkőzések megkülönböztetését.	Szöveg
|collapsed=	Az alkalmazásához pozitív értéket kell megadni (pl. i, igen, y, yes, 1). Alkalmazása esetén a táblázat összecsukható formátumú lesz.	Szöveg
|center_table=	Az alkalmazásához pozitív értéket kell megadni (pl. i, igen, y, yes, 1). Alkalmazása esetén a táblázat vízszintesen középre kerül.	String
|caption=	Hozzáad egy táblázatcímet.	Szöveg
|title=	Hozzáad egy címet a táblázathoz, az összes oszlopot összevonva.	Szöveg
|id=	Hozzáad egy horgonyt, amellyel közvetlenül a táblázathoz lehet hivatkozást készíteni.	Szöveg
|section=	Lehetővé teszi, hogy a táblázatnak azonosítónevet adjunk áthivatkozás céljából. Ez akkor hasznos, ha több modul van ugyanazon az oldalon a „transclusion” címkéken belül, lehetővé téve bizonyos táblázatok szelektív hívását egy másik oldalon. Ha a paraméter be van állítva, és a modul kódja <onlyinclude>...</onlyinclude> közé van helyezve, más oldalakon az áthivatkozás során a |transcludesection= használatával csak a megfelelő |section= táblázatokat fogja megjeleníteni, nem pedig az összeset.	Szöveg
|nowrap=	Az alkalmazásához pozitív értéket kell megadni (pl. i, igen, y, yes, 1). Alkalmazása esetén a táblázatban nem lesz sortörés.	Szöveg
|font_size=	A szöveg betűméretét egy adott százalékra módosítja. A százalékjel opcionális. Az alapértelmezett érték: 100. A 85-nél kisebb érték 85-öt jelent.	Szám
|fill_blanks=	A zászlóikon helyének hozzáadása a csapat neve melletti helyhez, ha a táblázatban vannak zászló paraméterek, de az adott csapathoz tartozó zászló paramétere üres. (|type=klub esetén) vagy nem tartalmaz zászlót (|type=vál esetén). Nincs hatása a |flag=false beállítás esetén.	Szöveg
|team_width=	A két csapat oszlopának szélességét állítja be pixelben, egész számot kell megadni. Alapértelmezett érték: 250.	Szám
|score_width=	Az összesítés és a mérkőzések oszlopainak szélességét állítja be pixelben, egész számot kell megadni. Alapértelmezett érték: 80.	Szám
|away_goals=	Negatív érték esetén (pl. n, nem, no, 0), a modul nem alkalmazza az „idegenben szerzett gólok” szabályát olyan kétmérkőzéses párosítások esetén, amelyekben az összesítés egyenlő. A modul alapértelmezés szerint az „idegenben szerzett gólok” szabályát alkalmazza a győztes meghatározásához.	Szöveg
|team1=	Egyedi címet ad az első csapat oszlopának. Az alapértelmezett érték: 1. csapat.	Szöveg
|team2=	Egyedi címet ad az második csapat oszlopának. Az alapértelmezett érték: 2. csapat.	Szöveg
|h_a= vagy |h_v=	Az alkalmazásához pozitív értéket kell megadni (pl. i, igen, y, yes, 1). Alkalmazása esetén a fejlécben az „1. csapat” és a „2. csapat” szöveg helyett „Hazai” és „Vendég” szöveg jelenik meg. A |team1= és a |team2= paraméterek felülírják ezt.	Szöveg
|aggregate=	Egyedi címet ad az „Összesítés” oszlopának. Az alapértelmezés {{Abbr|Össz.|Összesítés}}. Ha a |legs= paraméter negatív érték (pl. n, nem, no, 0), akkor a szöveg Eredmény.	Szöveg
|legN=	Egyedi címet ad az N-edik mérkőzés oszlopának (pl. |leg1= az 1. mérkőzéshez, |leg3= a 3. mérkőzéshez, stb.). Az alapértelmezés <sorszám> .mérk (pl. 1. mérk. az 1. mérkőzéshez, 3. mérk. a 3. mérkőzéshez, stb.).	Szöveg
|leg_prefix=	Megváltoztatja a mérkőzések fejlécének formátumát. A „<sorszám>. mérk” szöveg helyett a „<leg_prefix> <sorszám>” szöveg jelenik meg. Bármilyen karakterlánc megadható a paraméteren keresztül, amely a sorszám előtti előtagként jelenik meg. Pozitív érték esetén (pl. i, igen, y, yes, 1) az alapértelmezett N. mérk szöveg jelenik meg. A |legN= alkalmazása felülírja a |leg_prefix= szövegét az N-edik mérkőzés fejlécében.	Szöveg
|leg_suffix=	Egyedi szöveg állítható be a mérkőzések fejlécében. Az alapértelmezés mérk. A |legN= alkalmazása felülírja a |leg_suffix= szövegét az N-edik mérkőzés fejlécében. A |leg_prefix= alkalmazása felülírja a |leg_suffix= paramétert.	Szöveg
|headingN=	A táblázat N-edik sora felett egyedi címsor hozzáadása, az összes oszlopot összevonva.	Szöveg

Egyéb jellemzők

Mérkőzések és összesített eredmény

A mérkőzések és az összesített eredmény esetén a hibásan írt nagykötőjelet (pl. kötőjel, gondolatjel, kvirtmínusz) a modul nagykötőjellé konvertálja (–). Ez nem vonatkozik a wikilinkek cikkcím/szakaszhorgony részében található kötőjelekre.

Ezenkívül a modul automatikusan átalakítja a zárójelben lévő szöveget (a találatok eldöntésének módjára vonatkozóan) az alábbiak szerint.

• (t X–Y), (bü X–Y) → (t. X–Y)
• (hu) → (h.u.)
• (ig), (ilg) → (i.g.)

Üres eredmények

Ha egy mérkőzésnél a null adat szerepel, akkor a cellában egy párbeszédjel (—) lesz. A |solid_cell=i beállítással a mérkőzés cellája szürke (#BBBBBB) színű lesz.

Ha egy mérkőzésnél a nil adat szerepel, akkor a cella nem generálódik. Ezek a funkciók olyan esetekben hasznosak, amikor nem következetes a mérkőzések száma, például olyan esetekben, ahol két mérkőzés után újrajátszás is lehetséges.

Egyszerűsített horgonyok, könyvjelzők

A modult használó oldalak gyakran tartalmaznak egy wikilinket a mérkőzések eredményeinél, amely a mérkőzés részletesebb leírásához hivatkozik. A horgonnyal rendelkező wikilinkek használatakor az oldal címe elhagyható, ha a horgony ugyanazon az oldalon jelenik meg. Az ilyen hivatkozások azonban általában nem működnek megfelelően, ha más cikkekre vezetnek át.

Ha az összesítés és/vagy a mérkőzések olyan horgonyokat tartalmaznak, amelyből például kimarad az oldal címe (pl. [[#A vs B|2–2]]), ez a modul az áthivatkozás során automatikusan beilleszti az oldal címét, hogy biztosítsa a megfelelő hivatkozást. A megfelelő működés érdekében a modul kódjának ugyanarról az oldalról kell származnia, amely a horgonyokat tartalmazza.

Kiegészítő lehetőségek

Három aposztróf (''') az egyedi vastagbetűvel írt szöveghez

Bár a sablon automatikusan vastag betűvel jelöli a győztest (kivéve a |bold_winner=n) beállítás esetén), bizonyos esetekben a modul nem képes meghatározni a győztest. Ilyenkor manuálisan is lehet jelölni a győztest. Ez a |type=klub beállítás esetén egyszerűen elvégezhető, ha a csapat neve elé és után három aposztrófot teszünk. A |type=vál beállítás esetén a három aposztrófot közvetlenül az ország nevének/kódjának elé és mögé kell tenni. Ha a |bold_winner= nincs kikapcsolva, akkor a manuális jelölés felülírja a modul által meghatározott győztest. Ha a |color_winner= is be van állítva, akkor a manuálisan vastagbetűvel jelölt csapat cellája egyúttal színes is lesz. Öt aposztróf alkalmazásakor a megjelölt csapat vastagbetűs és a cella színes lesz.

(Megjegyzés: A három aposztróf használata ebben a modulban eltér a normál használattól. Ezért nem lehetséges a csapatparaméterek egyes részeinek szelektív vastagítása, míg az említett paraméterek más részeinek vastagítás nélkül hagyása).

Két aposztróf ('') az egyedi színezéshez

Bár a sablon automatikusan vastag betűvel jelöli a győztest (kivéve a |bold_winner=n) beállítás esetén), bizonyos esetekben a modul nem képes meghatározni a győztest. Ilyenkor manuálisan is lehet jelölni a győztest. Ez a |type=klub beállítás esetén egyszerűen elvégezhető, ha a csapat neve elé és után két aposztrófot teszünk. A |type=vál beállítás esetén a két aposztrófot közvetlenül az ország nevének/kódjának elé és mögé kell tenni. Ha a |color_winner= be van állítva, akkor a manuális jelölés felülírja a modul által meghatározott győztest. Ha a |bold_winner= nincs kikapcsolva, akkor a manuálisan színes cellával jelölt csapat egyúttal vastagbetűs is lesz. Öt aposztróf alkalmazásakor a megjelölt csapat vastagbetűs és a cella színes lesz.

(Megjegyzés: A három aposztróf használata ebben a modulban eltér a normál használattól. Ezért nem lehetséges a csapatparaméterek egyes részeinek szelektív vastagítása, míg az említett paraméterek más részeinek vastagítás nélkül hagyása).

Példák

1. példa

Minden alapértelmezés szerinti. Az eredményeknél a zárójelben lévő „t” szöveget „t.” szövegre (utalva a tizenegyesekkel való eldöntésre), a „hu” szöveget „h.u.” szövegre (utalva a hosszabbításra) cseréli.

{{#invoke:Sports series|main
|[[FC Bayern München|Bayern München]]|GER|3–3 (t 3–1)|[[Real Madrid CF|Real Madrid]]|ESP
|[[2011–2012-es UEFA-bajnokok ligája (egyenes kieséses szakasz)#Bayern München v Real Madrid|2–1]]
|[[2011–2012-es UEFA-bajnokok ligája (egyenes kieséses szakasz)#Real Madrid v Bayern München|1–2]] (hu)
|[[Chelsea FC|Chelsea]]|ENG|3–2|[[FC Barcelona]]|ESP
|[[2011–2012-es UEFA-bajnokok ligája (egyenes kieséses szakasz)#Chelsea v FC Barcelona|1–0]]
|[[2011–2012-es UEFA-bajnokok ligája (egyenes kieséses szakasz)#FC Barcelona v Chelsea|2–2]]
}}

1. csapat	Össz.Tooltip Aggregate score	2. csapat	1. mérk.	2. mérk.
Bayern München	3–3 (t. 3–1)	Real Madrid	2–1	1–2 (h.u.)
Chelsea	3–2	FC Barcelona	1–0	2–2

2. példa

A mérkőzések száma 0, azaz egymérkőzéses táblázat |legs=0. A fejlécben „Hazai” és „Vendég” szöveg szerepel |h_v=i. Zászló nem kell |flag=nem. A csapat oszlop szélessége 140 pixel |team_width=140. Az eredmény oszlop szélessége 60 pixel |score_width=60. A győztes nincs vastagbetűvel jelölve |bold_winner=nem. A táblázatban legfelül cím jelenik meg |title=1. forduló, hivatalos játéknap: 2023. július 29..

{{#invoke:Sports series|main|legs=0|h_v=i|flag=nem
|team_width=140|score_width=60|bold_winner=nem
|title=1. forduló, hivatalos játéknap: 2023. július 29.
|[[MTK Budapest FC|MTK]]|1–1|[[Paksi FC|Paks]]
|[[Diósgyőri VTK|Diósgyőr]]|0–1|[[Puskás Akadémia FC|Puskás Akadémia]]
|[[Újpest FC|Újpest]]|2–1|[[Fehérvár FC|Fehérvár]]
|[[Zalaegerszegi TE FC|Zalaegerszeg]]|0–2|[[Kisvárda FC|Kisvárda]]
|[[Debreceni VSC (labdarúgás)|Debrecen]]|3–1|[[Mezőkövesd Zsóry FC|Mezőkövesd]]
|[[Ferencvárosi TC (labdarúgás)|Ferencváros]]|1–0|[[Kecskeméti TE|Kecskemét]]
}}

1. forduló, hivatalos játéknap: 2023. július 29.
Hazai	Eredmény	Vendég
MTK	1–1	Paks
Diósgyőr	0–1	Puskás Akadémia
Újpest	2–1	Fehérvár
Zalaegerszeg	0–2	Kisvárda
Debrecen	3–1	Mezőkövesd
Ferencváros	1–0	Kecskemét

3. példa

A zászló értéke nem |flag=n. A mérkőzések száma 0, azaz egymérkőzéses táblázat |legs=0. A fejlécben „Hazai” és „Vendég” szöveg szerepel |h_v=i. Automatikusan színezi a győztest |color_winner=i. Táblázatcímet tartalmaz |caption=A ág. A táblázat első sora egyedi szöveget tartalmaz |heading1=Elődöntők. A táblázat harmadik sora egyedi szöveget tartalmaz |heading3=Döntő.

{{#invoke:Sports series|main|flag=n|legs=0|h_v=i|color_winner=i|caption=A ág|heading1=Elődöntők|heading3=Döntő
|{{lr-j|ISL}}|[[2020-as labdarúgó-Európa-bajnokság (pótselejtezők)#ISL v ROU|2–1]]|{{lr|ROU}}
|{{lr-j|BUL}}|[[2020-as labdarúgó-Európa-bajnokság (pótselejtezők)#BUL v HUN|1–3]]|{{lr|HUN}}
|{{lr-j|HUN}}|[[2020-as labdarúgó-Európa-bajnokság (pótselejtezők)#HUN v ISL|2–1]]|{{lr|ISL}}
}}

A ág

Hazai	Eredmény	Vendég
Elődöntők
Izland	2–1	Románia
Bulgária	1–3	Magyarország
Döntő
Magyarország	2–1	Izland

4. példa

A típus értéke válogatott |type=vál. A mérkőzések száma 3 |legs=3. A 3. mérkőzések esetén a 2., 3., 4. párosításoknál nil érték van megadva, amivel a cella üresen marad. Spanyolországnál a ESP+1945 használatával a {{lr-j|ESP|1945}} → Spanyolország zászlóvariáció jelenik meg.

{{#invoke:Sports series|main|type=vál|legs=3|color_winner=y
|LUX|5–6|DEN|3–3|2–2|0–1
|ESP+1945|7–1|IRL|5–1|2–0|nil
|FRA|2–5|HUN|1–2|1–3|nil
|SWE|2–4|URS|1–1|1–3|nil
}}

1. csapat	Össz.Tooltip Aggregate score	2. csapat	1. mérk.	2. mérk.	3. mérk.
Luxemburg	5–6	Dánia	3–3	2–2	0–1
Spanyolország	7–1	Írország	5–1	2–0
Franciaország	2–5	Magyarország	1–2	1–3
Svédország	2–4	Szovjetunió	1–1	1–3

5. példa

Az előző példa másképp. A 3. mérkőzés fejléce „Rájátszás” |leg3=Rájátszás. A 3. mérkőzések esetén a 2., 3., 4. mérkőzésekhez null érték van megadva. Az üresen maradt cellák szürke színűek |solid_cell=igen. A győztes vastagbetűvel jelölése kikapcsolva |bold_winner=n. Az első párosításnál a győztes nincs jelölve. A második párosítás győztese manuálisan színezett (két aposztróf). A harmadik párosítás győztese manuálisan vastagbetűs (három aposztróf). A negyedik párosítás győztese manuálisan színezett és vastagbetűs is (öt aposztróf). A manuális formázást közvetlenül az országkód mögött kell alkalmazni, ha van zászlóvariáció.

{{#invoke:Sports series|main|type=vál|legs=3|leg3=Rájátszás|solid_cell=igen|bold_winner=n
|LUX|5–6|DEN|3–3|2–2|0–1
|''ESP''+1945|7–1|IRL|5–1|2–0|null
|FRA|2–5|'''HUN'''|1–2|1–3|null
|SWE|2–4|'''''URS'''''|1–1|1–3|null
}}

1. csapat	Össz.Tooltip Aggregate score	2. csapat	1. mérk.	2. mérk.	Rájátszás
Luxemburg	5–6	Dánia	3–3	2–2	0–1
Spanyolország	7–1	Írország	5–1	2–0
Franciaország	2–5	Magyarország	1–2	1–3
Svédország	2–4	Szovjetunió	1–1	1–3

6. példa

Ha az eredményekhez tartozó cellákban nem „eredmény jellegű” (szám, kötőjel) szöveg van, akkor ezek a szövegek kisebb betűvel jelennek meg. A |fill_blanks=i használatával a zászló helye üresen marad. A csapat paraméterében a „*” karakter nem sablonra hivatkozik, hanem a beírt szöveget jeleníti meg.

{{#invoke:Sports series|main|type=vál|legs=0|h_v=i|color_winner=i|fill_blanks=i|heading1=Elődöntők|heading3=Döntő
|heading1=Elődöntők|heading3=Döntő
|POL|[[2024-es labdarúgó-Európa-bajnokság (pótselejtezők)#A1 v A4|márc. 21.]]|EST
|WAL|[[2024-es labdarúgó-Európa-bajnokság (pótselejtezők)#A2 v A3|márc. 21.]]|FIN
|*2. mérkőzés győztese|[[2024-es labdarúgó-Európa-bajnokság (pótselejtezők)#A5 v A6|márc. 26.]]|*1. mérkőzés győztese
}}

Hazai	Eredmény	Vendég
Elődöntők
Lengyelország	márc. 21.	Észtország
Wales	márc. 21.	Finnország
Döntő
2. mérkőzés győztese	márc. 26.	1. mérkőzés győztese

Kapcsolódó modulok

• Modul:Sports results
• Modul:Sports table