Šablona:Epizoda seriálu 2/doc
Šablona {{Epizoda seriálu 2}} umožňuje snadné zadávání informací o epizodách seriálů do textu v jednotné podobě.
Informace k šabloně[editovat zdroj]
Tato šablona využívá číslovaných parametrů.
Souběžně s touto šablonou vzniklo její dvojče – šablona {{Epizoda seriálu}} –, která namísto číslovaných parametrů využívá parametrů pojmenovaných. Ve výsledku vkládá stejný text jako tato šablona, ale zápis jejího kódu při editování je pro uživatele jednodušší (nevyžaduje, aby si pamatoval pořadí zadávaných parametrů), zato však v kódu článku zabírá více místa a znepřehledňuje jej.
Předchůdcem těchto šablon byla šablona {{EpizodySG}}, která sloužila pro vkládání informací o epizodách seriálů Hvězdná brána a Hvězdná brána: Atlantida. Oproti ní mají však tyto šablony několik zásadních vylepšení. Tím hlavním je implementace parametru vynechávat, který umožňuje vynechávat defaultně požadované údaje. Tím umožňuje uživateli zamezit neustálému opakování neměnících se informací o epizodě při použití šablony v jednom článku. Tyto šablony také nyní lze užít i pro epizody jiných seriálů než seriálů ze stvěta Hvězdné brány.
Účel šablony[editovat zdroj]
Tato šablona do textu vkládá zadané informace, dosazené do určitého rámce (vizte dále), o epizodě seriálu. U takto zadaných informací lze určit pád rámce, lze určit, že první písmeno bude velké, že v šestém pádě se má namísto předložky v psát předložka ve, lze určit, zda má šablona upozorňovat uživatele na chybějící informace, či je ignorovat.
Šablona obecně (pokud parametr vynechávat není definován, vizte sekci Popis parametrů šablony) vkládá takovýto text (údaje, které je třeba vyplnit manuálně, jsou zvýrazněny tučně):
- Pokud má parametr pád hodnotu 6:
- v/V/ve/Ve epizoda epizodě řada_2 řady seriálu ''[[Seriál_cs]]'' (poznámka) ''[[Název_cs (Seriál_cs)|Název_cs]]/[[Název2_cs|Název_cs]]'' (v jazyk_cs originále ''[[:zkratkawiki_org:Název_org (Seriál_org)|Název_org]]''/''[[:zkratkawiki_org:Název2_org|Název_org]]'')
- Pokud má parametr pád hodnotu 1:
- epizoda/Epizoda epizoda řada_2 řady seriálu ''[[Seriál_cs]]'' (poznámka) ''[[Název_cs (Seriál_cs)|Název_cs]]/[[Název2_cs|Název_cs]]'' (v jazyk_cs originále ''[[:zkratkawiki_org:Název_org (Seriál_org)|Název_org]]''/''[[:zkratkawiki_org:Název2_org|Název_org]]'')
Pořadí parametrů šablony[editovat zdroj]
Tato šablona využívá mnoha parametrů, které musí být uvedeny postupně v pořadí uvedeném níže (k údaji o pořadí je připsáno jméno parametru podle šablony {{Epizoda seriálu}}; pro další údaje o jednotlivých parametrech se podívejte na sekci Popis parametrů šablony níže):
- 1 – pád
- 2 – epizoda
- 3 – řada_1
- 4 – řada_2
- 5 – řada_6
- 6 – seriál_cs
- 7 – seriál_org
- 8 – poznámka
- 9 – název_cs
- 10 – název2_cs
- 11 – název_org
- 12 – název2_org
- 13 – jazyk_org
- 14 – zkratkawiki_org
- 15 – vynechávat
- 16 – velké
- 17 – ve
Zápis šablony při editaci by obecně vypadal jako v ukázce kódu níže (ve skutečnosti by namísto názvů parametrů měly být uvedeny hodnoty těchto parametrů, přičemž místo pro nedefinované parametry by se mělo nechat volné, vizte sekci Příklad použití šabony níže):
{{Epizoda seriálu 2|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17}}
{{Epizoda seriálu 2|pád|epizoda|řada_1|řada_2|řada_6|seriál_cs|seriál_org|poznámka|název_cs|název2_cs|název_org|název2_org|jazyk_org|
zkratkawiki_org|vynechávat|velké|ve}}
Popis parametrů šablony[editovat zdroj]
- Parametry vyžadované šablonou za všech okolností:
- 1 – pád – určuje, v jakém pádě bude text vložený šablonou (akceptované hodnoty jsou čísla 1 a 6).
- Parametry vyžadované šablonou pouze když není definován parametr vynechávat:
- 2 – epizoda – pořadí epizody v řadě seriálu (hodnota by měla být ve formátu pořadové číslice /1.; 2.; 3./);
- 4 – řada_2 – pořadové číslo řady seriálu (hodnota by měla být ve formátu pořadové číslovky v druhém pádě /první; druhé; třetí/);
- 6 – seriál_cs – název seriálu v češtině;
- 7 – seriál_org – název seriálu v originálním jazyce;
- 9 – název_cs – název epizody v češtině;
- 11 – název_org – název epizody v originálním jazyce;
- 13 – jazyk_org – originální jazyk seriálu (hodnota by měla být v šestém pádě /anglickém; francouzském; německém/);
- 14 – zkratkawiki_org – zkratka jazykové verze wikipedie, na níž je k nalezení článek o epizodě v originálním jazyce seriálu (en; fr; de).
- Parametry vyžadované šablonou pouze když je definován parametr vynechávat, parametr pád má hodnotu 6 a parametr epizoda není definován:
- 5 – řada_6 – pořadové číslo řady seriálu (hodnota by měla být ve formátu pořadové číslovky v šestém pádě /první; druhé; třetí/)
- Nepovinné parametry:
- 8 – poznámka – poznámka k epizodě v šestém pádě (vkládán mezi údaj o názvu seriálu v češtině a údaj o názvu epizody v češtině);
- 10 – název2_cs – manuálně určuje cestu k článku o epizodě seriálu na české Wikipedii (pokud je odlišná od název_cs (seriál_cs));
- 12 – název2_org – manuálně určuje cestu k článku o epizodě seriálu na Wikipedii určené zkratkou zkratkawiki_org (pokud je odlišná od název_org (seriál_org));
- 15 – vynechávat – pokud je definován, určuje, zda má šablona přeskakovat chybějící parametry (když není definován, uživatel je na absenci parametrů upozorněn výstražným textem);
- 16 – velké – pokud je definován, určuje, zda má první písmeno textu vkládaného šablonou být velké;.
- Parametry nepovinné pouze pokud má parametr pád hodnotu 6:
- 17 – ve – pokud je definován, určuje, jestli má na začátku textu vkládaného šablonou v šestém pádě být ve namísto v.
- Parametry nepovinné pouze pokud je definován parametr vynechávat, parametr epizoda není definován a parametr pád má hodnotu 1:
- 3 – řada_1 – pokud je definován, určuje pořadové číslo řady seriálu v prvním pádě (první; druhá; třetí).
Příklad použití šablony[editovat zdroj]
Při nedefinování parametru vynechávat a použití všech povinných parametrů a použití nepovinných parametrů ve a poznámka (povšimněte si prázdných míst mezi rourami pro nedefinované parametry), jako v tomto příkladu...
{{Epizoda seriálu 2|6|20.||desáté||Hvězdná brána|Stargate|poslední epizodě seriálu|Bez konce||Unending||anglickém|en|||ano}}
...vkládá šablona tento text:
- ve 20. epizodě desáté řady seriálu Hvězdná brána (poslední epizodě seriálu) Bez konce (v anglickém originále Unending)