Šablona:Kategorie/doc

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.

{{Kategorie|KAT}}	zařadí stránku do kategorie KAT, ovšem pouze pokud je stránka v hlavním jmenném prostoru (pouze jde-li o článek)
{{Kategorie|KAT|Wikicesty}}	zařadí stránku do kategorie KAT, ovšem pouze pokud je stránka v udaném jmenném prostoru Wikicesty
{{Kategorie|KAT||klíč}}	zařadí stránku do kategorie KAT, ovšem pouze pokud je stránka v hlavním jmenném prostoru (článek), a zatřídí ji tam podle klíče klíč
{{Kategorie|KAT|Wikicesty|klíč}}	zařadí stránku do kategorie KAT, ovšem pouze pokud je stránka v udaném jmenném prostoru Wikicesty, a zatřídí ji tam podle klíče klíč

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

Podrobně: w:cs:Nápověda: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

• w:cs:Wikipedie:Kategorizace