Dokumentace  

Tato šablona je velmi často použita (případně i dalšími šablonami).

Každá změna se tak projeví na mnoha místech. Editujte ji s maximální obezřetností, jen pokud víte jistě, co děláte. Pokud úprava způsobí nečekané následky, urychleně ji vraťte. Veškeré experimenty byste měli raději provádět na pískovišti nebo ve svém uživatelském prostoru.

Použití šablony

Tato šablona se používá v jiných šablonách k zařazování stránek (zpravidla článků) do určené kategorie jen v případě, že je ona šablona použita ve zvoleném jmenném prostoru, stránky v jiných jmenných prostorech kategorizovány nejsou.

Parametry

• {{{1}}} - prvním nepojmenovaným parametrem je udávána cílová kategorie, bez prefixu "Kategorie" i bez znaku ":".

Pro funkci je nutný, ale nezadá-li se, nenastane chyba, jen se neprovede vůbec nic. Existence zadané kategorie se netestuje.

• {{{2}}} - druhým nepojmenovaným parametrem je udáván jmenný prostor, ze kterého jediného budou stránky kategorizovány.

Není-li zadán, kategorizují se pouze články z hlavního prostoru Wikipedie: Přednastavená filtrace pouze článků je jeden z hlavních účelů této šablony.

• {{{3}}} - třetím nepojmenovaným parametrem je udáván řadicí klíč, pod kterým bude stránka do kategorie vložena.

Výchozím klíčem je jméno stránky bez jmenného prostoru, tedy {{PAGENAME}}. Tedy např. Wikipedie:Pískoviště by se zařadilo pod P.

Začlenění do šablony - Neočekávaná odřádkování a mezery

Při jakémkoli rozšiřování šablon existuje nebezpečí nechtěného přidání odřádkování. Zkušenosti wikipedistů říkají, že se mezi produkty dvou následných šablon v článcích objevují neočekávaná odřádkování, ačkoli by se výsledky měly těsně dotýkat a navazovat.

Možný vznik

Způsob vzniku nechtěného odřádkování, ukázka chybného případu:

<includeonly>
{{Kategorie|Dummy}}
</includeonly>
<noinclude>

Je vidět, že se do stránek vkládá veškerý výsledek, tedy i odřádkování v kódu šablony: Ta mohou vznikat před jí vygenerovaným obsahem, v něm i za ním.

Prevence vzniku

Správně, bez vzniku nechtěného odřádkování, ukázka správného případu:

<includeonly>{{Kategorie|Dummy}}</includeonly><noinclude>

Související stránky a šablony

• Wikipedie:Kategorizace
• {{Kategorizovat}} - požadavek na kategorizování stránky (zpravidla článku)