Š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 např. Wikipedie:Pískoviště by se zařadilo pod P.

Příklady použití

{{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|Wikipedie}}	zařadí stránku do kategorie KAT, ovšem pouze pokud je stránka v udaném jmenném prostoru Wikipedie
{{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|Wikipedie|klíč}}	zařadí stránku do kategorie KAT, ovšem pouze pokud je stránka v udaném jmenném prostoru Wikipedie, a zatřídí ji tam podle klíče klíč

Začlenění do šablony

Podrobnější informace naleznete v článku 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 měly výsledky těsně dotýkat a navazovat.

• 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 vlá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.

• 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:Enviwiki:Kategorizace
• {{Kategorizovat}} - požadavek na kategorizování stránky (zpravidla článku)