Nápověda:Jak dokumentovat šablony
Skočit na navigaci
Skočit na vyhledávání
Každá šablona by měla být náležitě zdokumentována a kategorizována, aby bylo zřejmé jakým způsobem a pro jaký účel ji lze použít.
Dokumentace šablony
Vlastní dokumentace šablony se neprovádí v obsahu šablony, ale na samostatné podstránky. Do šablony je nutné pouze bezprostředně za vlastní obsah šablony vložit následující řetězec:
<noinclude>{{Dokumentace}}</noinclude>
|
Pozor na odřádkování! U některých šablon může v takovém případě docházet k nežádoucí interpretaci. |
Zápis dokumentace k šabloně se pak provádí na její podstránce Doc. Tu lze zavolat buď přímo z URL, nebo kliknutím na příslušný odkaz v šabloně, která má vloženou šablonu {{Dokumentace}}
.
Náležitosti dokumentace
Každá dokumentace k šabloně musí obsahovat následující:
- Popis šablony - co dělá, k čemu slouží, pro jaký účel byla vytvořena
- Syntaxe - jak má vypadat zápis šablony, případně jaké lze u ní použít parametry
- Použití - ukázka interpretace šablony
- Kategorie - i šablony musí být odpovídajícím způsobem kategorizovány
U komplikovaných šablon je vhodné vložit hned na počátku obsahu dokumentace do párového tagu noinclude šablonu {{Složitá šablona}} , aby byl každý předem varován, že nežádoucí úpravou šablony může dojít k narušení její funkcionality
|
Kategorizace šablony
Kategorizace šablon se provádí výhradně se prostřednictvím dokumentační podstránky /Doc
- Každá šablona, která není podstránkou
- se zařadí do kategorie Kategorie:Šablony.
- Jde-li o šablonu, která je sama podstránkou nějaké šablony
- pak se zařadí do kategorie Kategorie:Šablony závislé
Dokumentace podstránek
Se provádí stejně jako u šablony, ovšem