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}}
- durch das Tag-Element
- 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 Bearbeiten
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> Bearbeiten
Wikisyntax: <tag>
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:}} Bearbeiten
Das Format lautet hier
{{#categorytree:
KatName|par1=
wert1|par2=
wert2}}
Beispiel:
{{#categorytree:Hilfe:|depth=0}}
ergibt:
Spezialseite Bearbeiten
Es ist ein normales Wikilink; der Name einer Basis-Kategorie kann nach einem Schrägstrich vorgegeben werden:
Weitere Parameter sind nicht möglich.
Parameter Bearbeiten
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 zurzeit1
. 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.
- Zeige den Namensraum
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
-
oder0
dargestellt werden. - Dies übersteuert die Option
mode
. - class style id
- (Nur beim Tag-Format) Standard-Attribute
Sonstiges Bearbeiten
- 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.