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
depthist 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
namespaceskö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
-oder0dargestellt 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.
Weitere Informationen
- Vorlage:Kategoriegraph
- Cloud-Helferlein:
- vcat/render – Erzeugen von Grafiken (früher Catgraph)