Hilfe:DPL
Bei Listen aller Art (momentan aber am wahrscheinlichsten bei Fertigkeitslisten) wird man beim Bearbeiten der Seite auf Abschnitte stoßen, wie
<DPL> category = ... ... allowcachedresults = true </DPL> (Aufruf als Parsererweiterung) |
oder | {{#dpl: | category = ... ... | allowcachedresults = true }} (Aufruf als Parserfunktion) |
Es handelt sich dabei um die Dynamic Page List-Erweiterung, die in der Regel dazu verwendet wird, Seiten in bestimmten Kategorien als formatierte Liste auszugeben.
In dieser Hilfe sollen nur die Grundlagen erklärt werden und ein paar Beispiele, wie man sie im Wiki findet. Falls man darüber hinaus mehr lernen möchte, steht die (englischsprachige) Anleitung der Erweiterung zur Verfügung.
Allgemeine Funktionsweise
Zwischen die Tags <dpl>...</dpl>
gehören eine Anzahl von Parameter = Werte
-Paaren, die durch einen Zeilenumbruch getrennt werden. Sie kontrollieren verschiedene Funktionsbereiche:
- Auswahl der Seiten (Ergebnisliste)
- Parameter die Kriterien angeben, nach denen Seiten ausgewählt werden. Am einfachsten z.B. nach der Mitgliedschaft in bestimmten Kategorien, aber auch Auswahl nach Titel, Links, Verwendung von Vorlagen und mehr.
- Auswahl des Inhalts
- Welcher Teil der jeweiligen Seite in der Ergebnisliste soll zur Ausgabe zur Verfügung stehen? Bei einfachen Listen z.B. nur der Titel. Bei den Fertigkeitenlisten wird die ganze Infobox ausgewählt (und umgeleitet).
- Formatierung
- Parameter die angeben, wie der ausgewählte Inhalt der jeweiligen Seite angezeigt werden soll.
- Sonstige
- Sonstige interessante Einstellungen.
Parameter
Auswahl der Seiten
Argument | Beispiel | Beschreibung |
---|---|---|
category | Wählt Seiten nach Mitgliedschaft in einer oder mehreren Kategorien aus. | |
category=Kategorie1|Kategorie2|Kategorie3 |
ODER-Verknüpfung: Alle Seiten, die in einer der aufgezählten Kategorien vorkommen. | |
category=Kategorie1&Kategorie2&Kategorie3oder category=Kategorie1 category=Kategorie2 category=Kategorie3 |
UND-Verknüpfung: Alle Seiten, die in allen aufgeführten Kategorien vorkommen. Zum Kombinieren mit der ODER-Verknüpfung muss die zweite Methode verwendet werden. | |
category=*GuildWiki |
Mit * vor der Kategorie werden Seiten in direkten Unterkategorien eingeschlossen. Im Beispiel werden alle Seiten in "GuildWiki" und alle Seiten in einer Unterkategorien von "GuildWiki" gewählt. | |
notcategory | Wählt Seiten die nicht in der angegebenen Kategorieliste vorkommen. Über die UND Verknüpfung mit category kann man so Seiten aus dem Ergebnis von category wieder ausschließen. | |
category=Kategorie1|Kategorie2 notcategory=Kategorie3 |
Alle Seiten, die in "Kategorie1" ODER "Kategorie2" sind, aber NICHT in "Kategorie3". | |
categorymatch notcategorymatch |
Wählt Seiten aus Kategorien, die dem (SQL) Muster entsprechen. % wirkt als Jokerzeichen (steht für beliebig viele beliebige Zeichen). Aufpassen: Unter Umständen bekommt man mit dieser Methode mehr Ergebnisse als man wünscht (oder unerwartete). | |
categorymatch=Kategorie% |
Alle Seiten, die in "Kategorie1" oder "Kategorie2" oder "Kategorie3" vorkommen und in allen anderen Kategorien, auf die das Muster passt. |
Auswahl des Inhalts
Formatierung
Argument | Beispiel | Beschreibung |
---|---|---|
mode | Kontrolliert das generelle Ausgabeformat. Mögliche Werte: unordered, ordered, none, inline, category und userformat | |
category=Kategorie1 mode=unordered |
Einfache ungeordnete Liste der Seiten in Kategorie1, wie beim HTML-Tag <ul> oder der Wiki-Syntax mit *. Weiter unterscheiden sich die folgenden Werte nur durch ihre Trennzeichen:
| |
mode=userformat |
Überlässt die Formatierung der Seiten in der Auswahl anderen Parametern üder die der Benutzer mehr Möglichkeiten zur Gestaltung bekommt. |