Hilfe:Kategoriebaum

{{#ifeq:12|12|{{#invoke:PageTree|subpages|Hilfe:!|subpager=Subpage}}}}

Es ist möglich, die Baumstruktur von ausgewählten Kategorien interaktiv zu durchsuchen, also dynamisch zu den Namen der Kategorien zu navigieren.

Das wird insbesondere angewendet auf Projektseiten im Wikipedia-Namensraum und gelegentlich in Portalseiten; kaum in Kategoriebeschreibungen.

Grundsätzlich gibt es zwei Möglichkeiten:

1. Festes Startlayout auf einer Funktionsseite
   • durch das Tag-Element <categorytree>
   • durch die Parser-Funktion {{#categorytree}}
2. Interaktiv über die Spezialseite Spezial:Kategorienbaum.

Diese Funktionalität benötigt bestimmte JavaScript-Funktionen (Ajax) und funktioniert möglicherweise nicht oder nur eingeschränkt, wenn JavaScript ausgeschaltet ist oder ein sehr alter Browser verwendet wird.

Syntax und Format

Das Resultat ist bei beiden eingebundenen Syntax-Varianten zunächst gleich; welche Notation bevorzugt wird, ist eine Geschmacksfrage. Die Tag-Syntax bietet jedoch zusätzliche Möglichkeiten zur Formatierung.

{{#invoke:Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}} Tag <categorytree>

Das Format lautet

<categorytree par1="wert1" par2="wert2">KatName</categorytree>

Der Name der Kategorie KatName muss angegeben werden; ansonsten sind alle Parameter optional.

Beispiel für die spezielle Hilfe:-Kategorie:

<categorytree depth="1">Hilfe:</categorytree>
ergibt:

<categorytree depth="1">Hilfe:</categorytree>

{{#invoke:Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}} Parser-Funktion {{#categorytree:}}

Vorlage:Hilfe/Wikitext-Parserfunktion Das Format lautet hier

{{#categorytree:KatName|par1=wert1|par2=wert2}}

Beispiel:

{{#categorytree:Hilfe:|depth=0}}
ergibt:

{{#categorytree:Hilfe:|depth=0}}

Spezialseite

Es ist ein normales Wikilink; der Name einer Basis-Kategorie kann nach einem Schrägstrich vorgegeben werden:

• [[Spezial:Kategorienbaum/Hilfe:]]

Weitere Parameter sind nicht möglich.

Der Startwert bei nicht angegebener Basis-Kategorie ist über MediaWiki:rootcategory definiert und soll bei uns „!Hauptkategorie“ lauten.

Parameter

Die Parameter sind hinsichtlich Namen und Werten bei beiden Syntax-Varianten gleich; auf der Spezialseite gibt es nur den Modus (mode) und einen Namensraum.

depth {{#invoke

Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}}

Anfangswert für die Verästelungstiefe der Darstellung.

Die Vorgabe für depth ist zurzeit 1. Gleichwohl sollte hier immer ein expliziter Wert eingetragen werden, wenn man sich dabei etwas gedacht hatte; Standard-Vorgaben können sich auch einmal überraschend ändern.

mode {{#invoke

Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}}

Legt fest, was im Baum gezeigt werden soll. Die Option namespaces könnte dies übersteuern.

Mögliche Werte:

• categories
  • Zeige nur die Unterkategorien.
• pages
  • Zeige Unterkategorien und einzelne Seiten, aber keine Dateien.
• all
  • Zeige Unterkategorien, Seiten und Dateien.
• parents
  • Zeige die übergeordneten Kategorien. Damit wird der Baum gewissermaßen invertiert.

hideroot {{#invoke

Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}}

Zeige die Wurzel KatName nicht an.

Format:   hideroot="on" (Tag)   bzw.   hideroot=on

Sollte besser nicht mit depth="0" kombiniert werden.

hideprefix {{#invoke

Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}}

Legt fest, ob die Namensräume der Einträge angezeigt werden sollen.

Mögliche Werte:

• categories
  • Zeige den Namensraum Kategorie: nie an, jedoch alle anderen.
  • Standard-Verhalten.
• always
  • Immer den Namensraum verstecken.
  • Sollte nur benutzt werden, wenn alle Seiten zum gleichen Namensraum gehören.
• never
  • Nie den Namensraum verstecken, noch nicht einmal bei Kategorien.
• auto
  • Verstecke den Namensraum, wenn nur Kategorien sichtbar sind.

showcount {{#invoke

Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}}

Zeige die Anzahl von Seiten und Unterkategorien.

Format:   showcount="on" (Tag)   bzw.   showcount=on

Standard-Verhalten:

• Auf in andere Seiten eingebundenen Syntax-Varianten: Keine Anzahl anzeigen.
• Auf der Spezialseite (und den Kategorie-Seiten): Anzahl anzeigen.

namespaces {{#invoke

Vorlage:Anker|f |errCat=Wikipedia:Vorlagenfehler/Vorlage:Anker |errHide=1}}

Eine Liste von Namensräumen, deren Seiten gezeigt werden sollen. Die Elemente der Auflistung müssen die Namen der Namensräume sein, durch Leerzeichen voneinander getrennt. Der Artikel-Namensraum kann durch - oder 0 dargestellt werden.

Dies übersteuert die Option mode.

class style id

(Nur beim Tag-Format) Standard-Attribute

onlyroot

• Seit 2008 veraltet.
• Kategorie:Wikipedia:Seite mit categorytree-Parameter onlyroot

Sonstiges

• Die Funktionalität ist in der deutschsprachigen Wikipedia verfügbar, aber nicht notwendigerweise in jedem anderen Wiki eingerichtet.
• Es gibt eine Lokalisierung kategorienbaum, die sich aber nur auf den Namen der Spezialseite bezieht und nicht für das Tag und nicht für die Parser-Funktion gilt.
• Mit einem Benutzerskript können alle Kategoriebäume in der Seite gleichzeitig um je eine Ebene auf- oder alles zugeklappt werden: catTreeToggling@PerfektesChaos.