Nápověda:Šablony
Z Wikipedie, otevřené encyklopedie
Šablony lze použít již hotové, nebo vlastní. Pro jejich vytvoření je nutné vědět něco málo o použití CSS stylů a HTML. Autor by měl zejména u složitější šablony poskytnout detailní návod na její použití včetně příkladů použití, který umístí na diskuzní stránku šablony.
Seznam všech existujících šablon najdete na Wikipedie:Šablony.
Obsah |
[editovat] Kód šablony
Vlastní šablona vypadá podobně jako běžný článek, ovšem může obsahovat přednastavené parametry, které se pak při použití nahradí vlastním obsahem encyklopedického hesla.
Příklad kódu šablony s parametry:
{| style="width:256px;padding:2px;border:1px solid;float:right"
! style="text-align:center;background-color:#efefef;font-weight:600;
font-size:larger" colspan="2" | <big>{{{jméno}}}</big>
|-
| style="text-align:center" colspan="2" | [[Image:{{PAGENAME}}.jpg|none|250px|{{{bublina}}}]]
{{{popisek}}}
|-
| style="text-align:center" colspan="2" | ''[[Wikiquote:{{PAGENAME}}|{{{motto}}}]]''
|-
! '''Narození''' || {{{datum_narození}}}, {{{rok_narození}}}<br/>{{{místo_narození}}}
|-
! '''Úmrtí''' || {{{datum_úmrtí}}}, {{{rok_úmrtí}}}<br/>{{{místo_úmrtí}}}
|}
[editovat] Mezijazykové odkazy
Do šablony se dávají mezijazykové odkazy na analogickou šablonu v jiných jazycích, případně informativní návod atp., mezi značky <noinclude> </noinclude> , které zajistí, že odkazy se nepřidají do článků, ve kterých je šablona použita.
[editovat] Testování šablon
U většiny šablon vám příliš nepomůže editační náhled, protože mu nemůžete předat parametry z reálného článku, kde bude šablona použita. Takže místo reálných hodnot uvidíte názvy parametrů ve složených závorkách, případně, pokud máte většinu parametrů volitelných, neuvidíte téměř nic. Šablonu si nemůžete otestovat ani na Wikipedie:Pískoviště, protože pískoviště není ve jmenném prostoru Šablona a nebude se tedy jako šablona chovat. Máte však následující možnosti:
Stránka pro rozbalení šablon. Jděte na Speciální:ExpandTemplates, do formuláře vyplňte volání šablony se všemi parametry, jak by se objevilo v reálném článku, a nechte si zobrazit výsledek. Podstatnou nevýhodou této metody je, že šablona musí být nejdřív uložená, takže to samé jste si vlastně mohli vyzkoušet na Pískovišti. Vy však typicky šablonu uložit nechcete, protože už je použita v řadě článků a pokud uděláte chybu (což je ve složitém kódu např. infoboxů docela snadné), pokazíte vzhled mnoha článků najednou. Místo abyste pak v klidu přemýšleli, jak chybu opravit, případně udělali ještě několik jiných pokusů, musíte rychle vše uvést do původního stavu.
Testovací šablona. Kód šablony, kterou měníte, zkopírujete do testovací šablony, kterou běžné články nevolají. Tuto testovací šablonu tedy můžete bez obav uložit. Pak už máte několik způsobů, jak si prohlédnout její vzhled s reálnými parametry: buď pomocí výše uvedené stránky pro rozbalení šablon, nebo voláním šablony z pískoviště, nebo si rovnou necháte zobrazit náhled článku, který šablonu používá: název původní šablony nahradíte názvem testovací šablony, parametry a umístění v článku zůstanou netknuté. A protože je to jen náhled, zbytek světa nic divného neuvidí. Až bude šablona odladěná, nahradíte novým kódem starý kód pod skutečným názvem šablony a uložíte ji. (Pozor, abyste neuložili článek, na kterém jste šablonu ladili, s odkazem na testovací šablonu.)
Aby nevznikala řada nevyužitých šablon, tak prosím pro testování vlastní šablony použijte šablonu Šablona:Test. Během práce s touto šablonou přidejte do jejího kódu šablonu {{Pracuje se}}, který vloží informaci, že se šablonou zrovna někdo něco dělá. Po skončení práce pak kód testovací šablony smažte, aby ji mohl použít někdo jiný.
[editovat] Parametry
(podporované ve verzi 1.3 a vyšší)
Parametry šablon jsou pojmenované, nebo číslované. Syntaxe je {{šablona_jméno|par_jméno1=par_hodnota1|par_jméno2=par_hodnota2}} s tagem {{{par_jméno}}} v šabloně, nebo {{šablona_jméno|par_hodnota1|par_hodnota2}} s použitím v šabloně {{{1}}}, {{{2}}}. (Všimněte si, že tagy parametů mají 3 složené závorky místo dvou.)
Mechanismus šablon tedy zahrnuje dva druhy nahrazování:
- volání šablony (dvojté závorky) jsou nahrazeny obsahem šablony
- parametry (trojité závorky) jsou nahrazeny hodnotou parametru
Od verze srpen 2004 může hodnota parametru obsahovat odkaz se svislítkem; znak "|" v takovém odkazu není považován za oddělovač parametru.
Při zobrazování jsou ignorovány přebytečné parametry. V případě menšího počtu parametrů je výsledek závislý na zbývajících parametrech.
Parametry jsou citlivé na velikost písmen i s respektováním prvního písmena a mezery jsou rozlišovány od podtržítka, i když stránka šablony tyto rozdíly nezobrazuje.
[editovat] Modifikátory šablon
| použití | vysvětlení |
|---|---|
| {{:xyz}} | Dvojtečka není modifikátor, ale označení hlavního jmenného prostoru. Srovnejte např. článek {{:Zpráva}} a šablonu {{Zpráva}} |
| {{int:xyz}} | Zobrazí {{MediaWiki:xyz}} nebo <xyz>, nikoliv šablonu {{xyz}}. Příklad: {{int:edit}} = Editovat. |
| {{msgnw:xyz}} | Je zobrazen zdrojový wikitext. |
| {{subst:xyz}} | Do stránky je uložen obsah šablony. |
[editovat] Proměnné
Toto je seznam proměnných, které mohou být použity ve wikitextu, nejen v šablonách. Způsob jejich zobrazení závisí na čase, projektu nebo stránce, ve které se vyskytuje.
Vlevo je uvedena proměnná, vpravo jak bude zobrazena.
[editovat] Konstanty závislé na projektu a parametrech
| {{ns:-2}} nebo {{ns:Media}} | Média |
| {{ns:-1}} nebo {{ns:Special}} | Speciální |
| {{ns:1}} nebo {{ns:Talk}} | Diskuse |
| {{ns:2}} nebo {{ns:User}} | Wikipedista |
| {{ns:3}} nebo {{ns:User_talk}} | Wikipedista_diskuse |
| {{ns:4}} nebo {{ns:Project}} | Wikipedie |
| {{ns:5}} nebo {{ns:Project_talk}} | Wikipedie_diskuse |
| {{ns:6}} nebo {{ns:Image}} | Soubor |
| {{ns:7}} nebo {{ns:Image_talk}} | Soubor_diskuse |
| {{ns:8}} nebo {{ns:MediaWiki}} | MediaWiki |
| {{ns:9}} nebo {{ns:MediaWiki_talk}} | MediaWiki_diskuse |
| {{ns:10}} nebo {{ns:Template}} | Šablona |
| {{ns:11}} nebo {{ns:Template_talk}} | Šablona_diskuse |
| {{ns:12}} nebo {{ns:Help}} | Nápověda |
| {{ns:13}} nebo {{ns:Help_talk}} | Nápověda_diskuse |
| {{ns:14}} nebo {{ns:Category}} | Kategorie |
| {{ns:15}} nebo {{ns:Category_talk}} | Kategorie_diskuse |
| závislé na idividuálním nastavení jmených prostorů: {{ns:100}}, {{ns:101}}, etc. |
Portál, Portál_diskuse, etc. |
| {{ns:100}} | Portál |
| {{ns:101}} | Portál_diskuse |
| {{SITENAME}} | Wikipedie |
| {{SERVER}} | http://cs.wikipedia.org |
| {{SERVERNAME}} | localhost |
| {{localurl:Jméno stránky}} | ../../../j/m/%C3%A9/Jm%C3%A9no_str%C3%A1nky.html |
| {{localurle:Jméno stránky}} | ../../../j/m/%C3%A9/Jm%C3%A9no_str%C3%A1nky.html |
| {{localurl:Jméno stránky|řetězec požadavku}} | ../../../j/m/%C3%A9/Jm%C3%A9no_str%C3%A1nky.html |
| {{fullurl:Jméno stránky}} | http://cs.wikipedia.org../../../j/m/%C3%A9/Jm%C3%A9no_str%C3%A1nky.html |
| {{fullurl:pagename|řetězec_požadavku}} | http://cs.wikipedia.org../../../j/m/%C3%A9/Jm%C3%A9no_str%C3%A1nky.html |
| {{int:fromwikipedia}} | Z Wikipedie, otevřené encyklopedie. |
[editovat] Závislé na čase
| {{CURRENTMONTH}} | 03 | |
| {{CURRENTMONTHNAME}} | březen | |
| {{CURRENTMONTHABBREV}} | 3. | |
| {{CURRENTMONTHNAMEGEN}} | března | -- genitiv názvu měsíce (pro některé jazyky) |
| {{CURRENTWEEK}} | 13 | |
| {{CURRENTDAY}} | 27 | |
| {{CURRENTDAY2}} | 27 | dvoumístné číslo (např. 01, 02) |
| {{CURRENTDAYNAME}} | úterý | |
| {{CURRENTDOW}} | 2 | --číslo dne v týdnu (0=neděle, 1=pondělí) |
| {{CURRENTYEAR}} | 2007 | |
| {{CURRENTTIME}} | 09:29 | |
| {{CURRENTTIMESTAMP}} | 20070327093251 | |
| {{NUMBEROFARTICLES}} | 63 351 | |
| {{NUMBEROFFILES}} | 8 378 |
NUMBEROFARTICLES: počet stránek v hlavním jmenném prostoru, které obsahují odkaz a nejsou přesměrovány, tj. počet článků, pahýlů obsahujících odkaz a nejednoznačných stránek.
Závisí to na systémové proměnné $wgUseCommaCount. Pokud je "true", počítadlo článků bude obsahovat pouze články obsahující čárky (","). Pokud je "false", bude započítávat články s odkazy ("[["). Implicitní nastavení v DefaultSettings.php je "false", může být změněno v LocalSettings.php.
[editovat] Závislé na stránce
| {{NAMESPACE}} | Nápověda |
| {{NAMESPACEE}} | N%C3%A1pov%C4%9Bda |
| {{PAGENAME}} | Šablony |
| {{PAGENAMEE}} | %C5%A0ablony |
| {{FULLPAGENAME}} | Nápověda:Šablony |
| {{FULLPAGENAMEE}} | N%C3%A1pov%C4%9Bda:%C5%A0ablony |
| {{TALKSPACE}} | Nápověda diskuse |
| {{SUBJECTSPACE}} | Nápověda |
| {{TALKPAGENAME}} | Nápověda diskuse:Šablony |
| {{SUBJECTPAGENAME}} | Nápověda:Šablony |
Šablony se zdvojeným E na konci zobrazují název stránky ve formě, která je použita v URL, tj. s podtržítky místo mezer a escape kódy speciálních znaků (diakritika ...), a proto se používá pro vytváření URL. Například na stránce jménem "Jiný test" PAGENAMEE produkuje "Jin%C3%BD_test". Podívejte se také na en:Help:Page name#Variables PAGENAME and PAGENAMEE (anglicky).
Při použití v šabloně tyto tři proměnné ukazují na stránku, ve které je šablona vložena, ne na stránku šablony.
[editovat] Kouzelná slůvka
| slovo | vysvětlení |
|---|---|
| __NOTOC__ | Vypne tabulku obsahu na stránce. |
| __FORCETOC__ | Vynutí si zobrazení tabulky obsahu. |
| __TOC__ | Umístí tabulku obsahu na dané místo (přebíjí __NOTOC__). |
[editovat] Další kouzla
| slovo | vysvětlení |
|---|---|
| __NOEDITSECTION__ | Vypne generování odkazu pro editaci jednotlivých sekcí. |
| __NEWSECTIONLINK__ | [MW1.7+] Přidá odkaz "+" vedle záložky editovat, pro vytvoření nové sekce na nediskuzních stránkách. |
| __END__ | Umožní uložit mezery na konci článku. |
[editovat] Formátování
| slovo | příklad | vysvětlení |
|---|---|---|
| {{LC:}} | {{LC:AbC dEf}} = abc def |
[MW1.5+] malá písmena |
| {{UC:}} | {{UC:aBc DeF}} = ABC DEF |
[MW1.5+] velká písmena |
| {{LCFIRST:}} | {{LCFIRST:Ab Cd}} = ab Cd |
[MW1.5+] první písmeno malé. |
| {{UCFIRST:}} | {{UCFIRST:aB cD}} = AB cD |
[MW1.5+] první písmeno velké. |
[editovat] Použití šablony
Jsou dva základní způsoby, jak vložit obsah šablony do stránky: {{Moje šablona}} a {{subst:Moje šablona}}.
Způsob {{subst:Moje šablona}} vytvoří kopii obsahu šablony a vloží ji do textu při uložení článku (substituce).
Bez slova "subst" bude aktuální obsah šablony vkládán do textu stránky vždy při prohlížení, kterýžto proces je známý jako "transkluze" (transclusion).
Jinými slovy, po úpravách šablony nemusíte opravovat stránky, které šablonu používají, pokud použijete tvar bez direktivy "subst".
Nápověda a krátké dočasné zprávy, které budou brzy smazány, by měly bý vkládány pomocí "subst" (výhodou také je, že obsah šablony se stane součástí zdrojového textu stránky). Standardní poznámky, které budou součástí stránky po delší dobu, by měly být vkládány bez direktivy "subst", aby se lépe udržovaly.
Pokud potřebujete upravovat obsah šablony po jejím vložení do stránky a nechcete, aby se změny v ní později udělané na této stránce projevily, použijte "subst". Jestliže nepotřebujete obsah měnit a chcete, aby se změny v šabloně automaticky projevily ve stránkách kam byla vložena, "subst" nepoužijte.
