Pomoc:Vytváranie šablón

K vytvoreniu šablóny je vhodné poznať aspoň základy úpravy stránok. Pokročilí redaktori môžu prípadne využiť aj CSS štýly a HTML kódy. Pre komplexnejšie šablóny je možné využiť aj tzv. moduly(cs). Hlavne u zložitejších šablón sa hodí poskytnúť detailný návod na jeho použitie s príkladmi, ktorý sa umiestňuje na jej dokumentačnú podstránku.

Zjednodušený návod

Po kliknutí na zakrúžkovanú šablónu sa objaví okno s nápisom *Hladať šablónu*

Pred vytvorením šablóny vždy skontrolujte, či dotyčná šablóna už existuje. Všetky existujúce šablóny potom nájdete priamo v kategórii Wikipédia:Šablóny. Ku kontrole môžete taktiež skúsiť hladať možné názvy vo vyhladávacom poli vpravo hore.
Ak ešte šablóna neexistuje, môžete ju vytvoriť. Ak ide o infoboxy, navboxy (navigačné lišty), správy alebo šablóny, na ktorých sú postavené iné šablóny, tak sa vrátťe na stránku šablóny, ktorú chcete vytvoriť, kliknite na paneli nástrojov na skladačku. Po kliknutí sa objaví okno s nápisom Hladať šablón. Nájdite si tam šablónu, ktorá bude sedieť na vašu šablónu. Ak si nájdete takú šablónu, kliknite na text. Ak nie ste si istý, skúste pozrieť najprv ich dokumentácie.
Vyplňte parametre (ak nie ste si istý, aká , použite tlačidlo Pridať všetky parametre)

Ak ste nenašli žiadnu formátom podobnú šablónu, ktorá by sa hodila na vašej novej šablóne, môžete sa pokúsiť šablónu sami zostaviť. Čítajte ďalej

Kód šablóny

Kód šablón na rozdiel od článkov a iných stránok často obsahuje parametre označené tromi zloženými zátvorkami, napr. {{{1}}} alebo {{{názov}}}. Pri použití šablóny, ak sa vyplnia hodnoty, tak sa použijú na miesto odpovedajúcich parametrov. Ďalším prvkom často používaným v šablónach sú tzv. Magic words, napr. {{PAGENAME}}, ktoré sa nahradia názvom článku, do ktorého je šablóna vložená.

Príklad kódu šablóny s parametrami (šablóna {{Na úpravu}})

{{Správa
| typ           = štýl
| obrázok       = [[Súbor:Broom icon.svg|44px]]
| pravý obrázok = 
| štýl          = 
| text          = '''Tento článok alebo jeho časť si vyžaduje úpravu, aby zodpovedal vyššiemu štandardu kvality.'''<br/><small>Prosím, pozrite si stránky [[Pomoc:Obsah|pomocníka]], odporúčanie pre [[Wikipédia:Encyklopedický štýl|encyklopedický štýl]] a článok [{{fullurl:{{FULLPAGENAME}}|action=edit}} vhodne upravte].</small>
{{#if:{{{1|}}}|
----
<small>{{{1|}}}</small>}}{{#if:{{{2|}}}|<small> ''({{#time: j. n. Y|{{{2|}}}}})''</small>}}
}}<!--
--><includeonly>[[Kategória:Wikipédia:Články na úpravu]]</includeonly><!--
--><includeonly>{{#if: {{{1|}}} | {{#if: {{{2|}}} | {{#ifexpr: {{#invoke:String|find|{{{1}}}|Robot odstránil šablónu|0|1}} > 0 | [[Kategória:Wikipédia:Články na úpravu po odstránení Pracuje sa| {{{2|}}}]] }} }} }}</includeonly><!--
--><noinclude>

[[Kategória:Šablóny na upozornenie v článkoch|Upraviť]]

</noinclude>

Časti šablóny

Vlastný kód šablóny je tvorený inou šablónou, {{Správa}}, ktorá zobrazuje úvodné upozornenie. V šablóne Správa sú vyplnené jednotlivé parametre, ktoré určujú typ, ikonu, nadpis, text a poznámku. V šablóne sú 2 parametre, prvá v šablóne {{Na úpravu}} je poznámka, ktorá sa vloží prvím nepomenovaným parametrom {{{1|<noinclude>príklad poznámky</noinclude>}}}, text „príklad poznámky“ sa zobrazí len ak prvý parameter nie je vyplnený. Druhý parameter sa používa botom, keď po 14 dňoch odstráni šablóna {{Pracuje sa}}.

Ďalej nasleduje zaradenie článku do kategórie článkov k úprave. Značky <includeonly> zaistia, že sa do nej nevloží aj stránka šablóny, na ktorej sa táto značka nachádza.

Potom nasleduje časť označená značkami <noinclude>, ktorá sa do článkov nevkládá. Obsahuje dve šablóny, uzamknutie pred vandalizmom a dokumentácie (nápovedu), ktorá sa kompletne s kategorizáciou šablóny preberá z jeho umiestenia na podstránke /Dokumentácia.

Vkladaná a nevkladaná časť kódu

V šablóne bývá vlastný obsah šablóny, ktorý sa vkladá do stránky, a nevkladané časti šablóny, ktoré sa zobrazujú len na stránke šablóny ako napr. dokumentácie šablóny, kategórie šablóny, a podobne.

V šablóne môžete označiť časti, ktoré sa vkladať nemajú (značka noinclude):

Vlastný obsah šablony…
<noinclude> Dokumentácia…  </noinclude>

Hlavne u vkladaní kategórií do článkov pomocou šablóny je potrebné označiť časti, ktoré se vkladať majú, ale na stránke šablóny se vložiť nemajú (značka includeonly):

Vlastný obsah šablony…
<includeonly> Kategórie článku… </includeonly>

Kategórie

V šablonách sa kategorie používají k dvom účelom:

zaradenie stránky šablóny do špeciálnej kategorií,
automatického zaradenia článku (stránky), do ktorého je šablóna vložená, do kategórie.

1. Stránky šablón sa radia do špeciálnych kategórií v kategórii Wikipédia:Šablóny. Kategória šablóny musí byť v nevkladanej časti stránky, obvykle na konci stránky. Príkladom môže byť Kategória:Šablóny na upozornenie v článkoch

2. Články (či iné stránky) sa do príslušnej kategórie zaradia, ak je kategória obsiahnutá vo vkladanej časti šablóny. Kategorizácia prostredníctvom šablón sa najčastejšie využíva pre zaraďovanie článkov do údržbových kategorií. Skvelým príkladom je šablóna {{Urgentne upraviť}}, ktorá do článkov na urgentnú úpravu vkladá Kategória:Wikipédia:Články na urgentnú úpravu. Aby boli do kategórie zaradené len články a nie šablóna, je potrebné použiť kód <includeonly>[[Kategória:Názov]]</includeonly>.

Testovanie šablón

Pri editácií šablón máte možnost vyplniť meno stránky, v ktorom je šablóna vložená, a v náhľade uvidíte, ako bude vyzerať s práve editovanou verziou tejto šablóny.

Ale nie vždy ide túto funkciu použiť. Potom máte nasledujúce možnosti:

Testovanie na podstránke /testy: Najprv vytvorte šablónu a uložte ju. Tým vytvoríte novú stránku šablóny, z ktorej môžete robiť podstránky. Vytvorte podstránku zvanú testy. Tu zadajte kód šablóny v tvare {{Meno šablóny|}} a prípadné parametre doplňte v tvare |názov parametru = hodnota parametru .
Testovanie na redaktorskej podstránke: Najprv šablónu vytvoríte na svojom pieskovisku označené ako Redaktor:Meno Redaktora/pieskovisko alebo kliknite na odkaz pieskovisko úplne hore pri redaktorských informáciách. Potom na novej karte internetového prehliadača choďte na ďalšiu podstránku, napr. na Redaktor:Meno Redaktora/testnáhľad. Tu vyplňte šablónu so všetkými parametrami. Keď budete spokojný, stlačte tlačidlo Zobraziť náhľad. Skontrolujte šablónu. Po skončení tohto testovania zavrite kartu, ktorá sa volá Vytváranie stránky Redaktor:VašeRedaktorskéMeno/testnáhľad.

Neočakávané odriadkovanie

Pri testovaní šablón je potreba ustrážiť vznik nežiadúceho odriadkovania alebo vloženie medzery, ktorá sa neprejaví pri samostatnom použití šablóny, ale v kombinácii s ďalšou šablónou či kúzelným slovíčkom.

Parametre šablón

Parametre šablón sú buď pomenované, alebo číslované. Obidva spôsoby ale tiež idú vzájomne kombinovať.

Ak sa pri volání šablóny vyskytne viac zadaných parametrov, než zobrazenie šablóny potrebuje, budú nadbytočné parametry ignorované. V opačnom prípadě (teda pokiaľ je zadané menej parametrov) je výsledok volanej šablóny závislý na ostatných parametroch.

Od augusta 2004 môžu jednotlivé zadané parametre šablóny obsahovať aj zvislú čiaru (symbol „|“), ktoré nie sú považované za oddelovač v parametre.

Pomenované parametre

Z článku šablónu voláme:

{{Názov volanej šablóny
 | parameter A = hodnota parametra A
 | parameter B = hodnota parametra B
 | parameter C = hodnota parametra C
}}

Pri tvorbe vlastnej šablóny pracujeme s jednotlivými zadanými hodnotami pomocou ich názvu, ktoré budú obalené troma pármi zložených zátvoriek. Napríklad: {{{parameter A}}}, {{{parameter B}}} a {{{parameter C}}}.

Názvy parametrov sú citlivé na veľkosť písmen či prítomnosť medzery. Tým pádom totožné nie sú parametre názov a Názov, ani názov a nazov či pomenovanie stavby a pomenovanie_stavby.

Oproti číslovanému zápisu parametrov šablóny má však tento zápis výhodu v možnosti premenného poradia zadávania parametrov šablóny. Totožný výstup bude šablóna dávať pri volaní:

{{Název volané šablony
 | parameter A = hodnota parametra A
 | parameter B = hodnota parametra B
 | parameter C = hodnota parametra C
}}

a aj tak pri tomto volaní s prehodeným poradím zápisu prvých dvoch parametrov.

{{Název volané šablony
 | parameter B = hodnota parametra B
 | parameter A = hodnota parametra A
 | parameter C = hodnota parametra C
}}

Ale ak bude parameter vo volanej šablóne zadaný viackrát, použije sa posledný zadaný a stránka bude zaradená do údržbovej kategórie Stránky s duplicitnými parametrami pri volaniach šablón.

Číslované parametry

Z článku šablónu voláme (povšimnite si, že tu nie sú použité znaky ako napríklad = alebo pomenované parametre):

{{Název volané šablony
 | hodnota parametru A
 | hodnota parametru B
 | hodnota parametru C
}}

Pri tvorbe vlastnej šablóny pracujeme s jednotlivými zadanými hodnotami podľa poradia ich zadania (číslované sú od jednotky a vyššie). Číslo poradia obalíme trojicou párov zložených zátvoriek, teda napríklad {{{1}}}, {{{2}}} a {{{3}}}.

Kombinácie typov parametrov

Obidva spôsoby zadávania parametrov (pomenovaných a číslovaných) ide vzájomne kombinovať. V takom prípade budú pri volaní šablóny:

zadané hodnoty pomenovaných parametrov priradené k hodnotám príslušne pomenovaných parametrov
zadané hodnoty nepomenovaných (tedy číslovaných) parametrov priradené podľa poradia ich zadania k ostávajúcim parametrom šablóny

Príklad

Príkladom bude šablóna pomenovaná „Pokus“ ktorá má túto podobu:

* Vypíš prvý parameter: {{{parameter A}}}
* Vypíš druhý parameter: {{{1}}}
* Vypíš tretí parameter: {{{2}}}
* Vypíš štvrtý parameter: {{{parameter B}}}

Pri jej volání:

{{Pokus | parameter A = stôl | dvere | parameter B = stolička | okno}}

vypíše

Vypíš prvý parameter: stôl
Vypíš druhý parameter: dvere
Vypíš tretí parameter: okno
Vypíš štvrtý parameter: stolička

Špeciálne rozšírenia

Kúzelné slová

Pozri aj Help:Magic words

Pri tvorbe šablón môžete tiež využiť niektoré kódy pre speciálne účely nazývané kúzelné slová. Patria k nim kódy ovlivňujúce zobrazenia obsahu článku (napr. __NOTOC__ ich skryje), editovanie sekcií (__NOEDITSECTION__ zakáže editáciu jednotlivých oddielov stránky), skrytie kategórii (__HIDDENCAT__ zaradí kat. medzi skryté kategórie.)

Premenné

Špeciálne šablóny sú premenné, ktoré sa zobrazují jako rôzné hodnoty v závislosti na použití. Napríklad {{CURRENTTIME}} zobrazí aktuálný čas alebo {{TALKPAGENAME}} napíše link na diskusiu stránky.

Malé a veľké písmena

slovo	príklad	vysvetlenie
{{LC:}}	{{LC:AbC dEf}} = `abc def`	[MW1.5+] malé písmená
{{UC:}}	{{UC:aBc DeF}} = `ABC DEF`	[MW1.5+] veľké písmená
{{LCFIRST:}}	{{LCFIRST:Ab Cd}} = `ab Cd`	[MW1.5+] prvé písmeno malé.
{{UCFIRST:}}	{{UCFIRST:aB cD}} = `AB cD`	[MW1.5+] prvé písmeno veľké.

Použitie šablón

Oneskorené zmeny

Zmeny v šablóne sa môžu na stránkach, ktoré ju používají, neprejaviť hneď. Vynútiť ich okamžité ukázanie sa dá pomocou akcie Purge, napríklad pridaním ?action=purge do url adresy.

Stránky používajúce šablónu

Ak chcete zistiť, ktoré stránky používajú danú šablónu používajú, môžete využiť stránku Special:ČoOdkazujeSem.

Pozri aj

Wikipedie:Název šablony nebo modulu (česká wikipedie)
Nápověda:Vytvoření infoboxu (česká wikipedie)