Makro: Dir

Makros : Eingebaute Makros | Eigene Makros definieren

Das Makro Dir listet ein Inhaltsverzeichnis auf der Seite an der Stelle des Makros, wobei über diverse Optionen beeinflusst werden kann, ob das ganze Verzeichnis oder nur Teile davon gelistet werden sollen.

Syntax

{{Dir|Root|Start|Count|Levels}}
Root: Optional, Default = ""
Wurzel des Verzeichnisses (Seitenname). Wird Root nicht angegeben oder ist Root ein Minuszeichen, so wird das ganze Verzeichnis gelistet. Wenn für Root ein * eingegeben wird, so wird * durch den aktuellen Seitennamen ersetzt und es wird nur der entsprechende Ast des Verzeichnisses gelistet.
Start: Optional, Default = 0
Nummer des ersten zu listenden Haupteintrags. Die Nummerierung beginnt bei 0. Nur die Haupteinträge (unterste Stufe der ausgegebenen Hierarchie) werden nummeriert. Wird Start = -1 gesetzt, beginnt das Listing in der Mitte (bei Anzahl Einträge + 1 div 2).
Count: Optional, Default = 0
Anzahl zu listende Haupteinträge. 0 bedeutet alles ab Start. Wird Count = -1 gesetzt, wird die Hälfte der Haupteinträge gelistet, begonnen bei Start (Anzahl Einträge + 1 div 2).
Levels: Optional, Default = 0
Maximale Anzahl zu listende Hierarchiestufen. 0 bedeutet alle Stufen. 1 listet nur die Haupteinträge.

Das Inhaltverzeichnis muss mit einem der Makros DirPage oder MainMenu geladen werden, bevor es mit Dir ausgegeben werden kann.

Verwende das Makro DirFrom wenn du die Seite mit dem Inhaltverzeichnis zusammen mit dem Makro angeben willst. In diesem Fall kannst du mehrere verschiedene Verzeichnisse auf einer Seite ausgeben.

Verwende das Makro SubDir wenn nur ein bestimmter Ast des Verzeichnisses geöffnet werden und allenfalls ein bestimmter Eintrag darin markiert werden soll.

Formatierung des Listings

Durch Formatierungs-Makros kann das Aussehen der Liste beeinflusst werden: 

{{div|$WikiDir}}
{{Dir}}
{{end div}}

Listing mit mehreren Spalten

Mit Hilfe des Makros DirCol2 kann ein Listing in zwei Spalten aufgeteilt werden, wobei die Spalten untereinander platziert werden, wenn das Fenster zu schmal wird. 

{{DirCol2|3}}

Listet die Haupteinträge 0 bis 2 in der ersten Spalte und alle weiteren Haupteinträge ab 3 in der zweiten Spalte.

Das Makro DirCol2 ist in der Datei /app_stuff/layout.inc definiert.

Weitere Makros zur Ausgabe von Verzeichnissen

Die folgenden Makros können für die Ausgabe von Verzeichnissen verwendet werden:

Dir Verzeichnis oder Teil davon mit allen Subelementen auflisten.
DirCol2 Wie Dir aber Liste in zwei Spalten darstellen.
DirFrom Verwende diese Variante statt Dir, wenn du explizit die Seite mit dem Inhaltsverzeichnis angeben willst oder must.
SubDir Verzeichnis oder Teil davon auflisten, wobei nur ein ausgewählter Ast mit seinen Subelementen aufgelistet wird. Ein ausgewähltes Subelement kann markiert werden.
SubDirFrom Verwende diese Variante statt SubDir, wenn du die Seite mit dem Inhaltsverzeichnis angeben willst oder must.
MainDir Wie SubDir, listet jedoch das Verzeichnis am Seitenrand auf.
MainMenu Wie SubDirFrom, listet jedoch das Verzeichnis am Seitenrand auf.