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 | Quelltext 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 | Quelltext 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 | Quelltext bearbeiten]Wikisyntax: {{:}}
- 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:
Spezialseite
[Bearbeiten | Quelltext 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 | Quelltext 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
onlyroot
- Seit 2008 veraltet.
- Kategorie:Wikipedia:Seite mit categorytree-Parameter onlyroot
Sonstiges
[Bearbeiten | Quelltext 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.