Hilfe:Kategoriebaum

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:

Festes Startlayout auf einer Funktionsseite
- durch das Tag-Element <categorytree>
- durch die Parser-Funktion {{#categorytree}}
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.

Tag <categorytree>

Wikisyntax: <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:

Parser-Funktion {{#categorytree:}}

Wikisyntax: {{:}}

{{#categorytree:}}

Pflicht: 1
Optional:
depth=
mode=
hideroot=
hideprefix=
showcount=
namespaces=

Das Format lautet hier

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

Beispiel:

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

Hilfe:

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.

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

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

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

Zeige die Wurzel KatName nicht an.

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

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

hideprefix

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

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: 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.