Benutzer:Phorgo/Labor/Hilfe:DPL
Eine DPL wird nach folgendem Muster eingebunden:
<dynamicpagelist>
parameter = wert
parameter = wert
parameter = wert
…
</dynamicpagelist>
Falls einer der Parameterwerte mit einem Leerzeichen beginnt oder endet, muss dieses durch __S
ersetzt werden, da jeglicher Leerraum am Anfang und am Ende abgeschnitten wird.
Unter Umständen muss bei den Formatierungsparametern mal ein Zeilenumbruch gesetzt werden. Da Zeilenumbrüche als Parametertrenner dienen, muss stattdessen __N
geschrieben werden – anders als bei Leerzeichen auch innerhalb eines Parameterwertes.
Für den unwahrscheinlichen Fall, dass eine dieser beiden Zeichenfolgen mal literal, also ohne technische Bedeutung, als Fließtext dargestellt werden soll, kann man mit __U
einen Unterstrich erstellen. __U_S
wird folglich zu __S
.
Inhaltsverzeichnis
Seiten auswählen
Es gibt mehrere Parameter, mit denen man die anzuzeigenden Seiten eingrenzen kann. Grundsätzlich muss jedoch mindestens einer der Parameter namespace
, category
oder regex
angegeben werden.
namespace
Schränkt die Liste auf Seiten im angegebenen Namensraum ein. Dieser Parameter kann nur einmal gesetzt werden und erfordert als Wert die ID des jeweiligen Namensraums. Diese sind auf Stupidedia:Namensräume aufgelistet. Namensräume mit negativer ID, sogenannte virtuelle Namensräume, werden von der DPL nicht akzeptiert.
category
Listet nur Seiten, die sich in der angegebenen Kategorie befinden. Gibt man diesen Parameter mehrfach an, müssendie Seiten in allen angegebenen Kategorien stehen.
Das Präfix Kategorie:
ist erforderlich, falls der Kategorienname mit einem Namensraumpräfix beginnt. category = Nazischeiße
funktioniert also, category = Stupidedia:Hammer-Artikel
muss jedoch als category = Kategorie:Stupidedia:Hammer-Artikel
geschrieben werden.
notcategory
Seiten, die sich in dieser Kategorie befinden, werden nicht gelistet. Dieser Parameter kann auch mehrfach notiert werden. In dem Fall werden alle Seiten ignoriert, die sich in mindestens einer der angegebenen Kategorien befinden.
Für Kategorien, die mit einem Namensraumpräfix beginnen, gelten die gleichen Regeln wie beim Parameter category
.
regex
Es werden nur Seiten gelistet, auf die der angegebene reguläre Ausdruck zutrifft. Der Ausdruck ist case-sensitive und gilt für den Seitentitel ohne Namensraumpräfix. Fehlerhafte Ausdrücke verursachen einen Matrixfehler, der jedoch ohne weitergehende Folgen bleibt.
redirects
Gibt an, wie Weiterleitungen behandelt werden sollen:
-
exclude
: Weiterleitungen werden nicht gelistet. Das ist die Standardeinstellung. -
include
: Alle Seiten werden angezeigt, ob Weiterleitungen oder nicht. -
only
: Es werden nur Weiterleitungen in die Liste aufgenommen.
count
Legt fest, wie viele Ergebnisse angezeigt werden sollen. Dies können maximal 200 sein.
offset
Falls die Listeneinstellungen mehr Seiten erfassen, als count
ermöglicht, kann man mit diesem Parameter eine beliebige Anzahl Seiten am Anfang der Liste ausschließen. offset = 200
zeigt erst Seiten ab ausschließlich Nr. 200.
Sortierung
Eine DPL kann nach verschiedenen Kriterien sortiert werden.
ordermethod
Legt das Sortierkriterium fest. Dabei sind folgende Werte möglich:
-
categoryadd
: Sortiert die Seiten nach dem Zeitpunkt, zu dem sie in die erstdefinierte Kategorie eingefügt wurde. Funktioniert nur, wenn eine Kategorie angegeben wurde. -
created
: Die Seiten werden nach ihrem Erstellungsdatum respektive ihrer ID sortiert. -
lastedit
: Sortiert nach dem Zeitpunkt der letzten Bearbeitung. -
length
: Sortiert nach der Seitenlänge in Bytes. -
popularity
: Die Seiten werden nach der Anzahl ihrer Aufrufe sortiert. -
sortkey
: Sortiert nach dem Kategoriensortierungsschlüssel. Funktioniert nur, wenn eine Kategorie angegeben wurde und ist in den meisten Fällen identisch mit der Sortierung nach Titel. -
title
: Sortiert die Seiten nach ihrem Titel ohne Namensraumpräfix. Dies ist die Standardeinstellung. -
awards
: Sortiert nach Awards, entsprechend ihrer Gewichtung. Hat nur einen Effekt, wenn eine Gewichtung festgelegt ist (wie z.B. beim Daumen). -
random
: Zufällige Sortierung.
order
Legt fest, ob die Seiten aufsteigend oder absteigend sortiert werden sollen.
-
ascending
sortiert die Seiten aufsteigend nach dem angegebenen Sortierkriterium. -
descending
sortiert absteigend.
Formatierung
Es gibt diverse Möglichkeiten, eine DPL zu formatieren. Neben einigen vordefinierten Formatierungen kann man auch selber welche erstellen.
mode
Legt die Formatierungsbasis fest. Dies können folgende sein:
-
gallery
: Formatiert die Liste als Galerie, was natürlich nur bei Dateilisten Sinn macht. -
inline
: Die Seiten werden in einer Zeile dargestellt und mit Kommata voneinander getrennt. -
none
: Trennt die Listenelement mit br-Tags, also einfachen Zeilenumbrüchen voneinander. -
null
: Gar nichts, die Seiten stehen nebeneinander wie die Pendler in der U-Bahn. -
ordered
: Darstellung als geordnete Liste, entspricht einem#
am Anfang einer Zeile. -
unordered
: Wieordered
, nur ungeordnet, also*
statt#
. Dies ist der Standard.
Die folgenden fünf Parameter überschreiben mode
. Sie dienen dazu, die DPL exakt zu formatieren und sind folgendermaßen zu verstehen:
startliststartitemSeiteenditemitemseparatorstartitemSeiteenditemitemseparatorstartitemSeiteenditemitemseparatorstartitemSeiteenditemitemseparatorstartitemSeiteenditemendlist
Im Fall von mode = unordered
sieht das so aus (itemseparator
ist dabei nicht vorhanden):
<ul><li>Seite</li><li>Seite</li><li>Seite</li><li>Seite</li><li>Seite</li></ul>
startlist
Wikicode, der sich am Anfang der Liste befindet.
endlist
Wikicode am Ende der Liste, der mit startlist
die Liste umfasst.
startitem
Dieser Kram befindet sich vor jedem einzelnen Listenelement.
enditem
Das befindet sich am Ende jedes Listenelements
itemseparator
Wikicode, der sich zwischen den einzelnen Listenelementen befindet. Nützlich für z. B. Zeilenumbrüche oder Kommata.
addfirstcategorydate
Fügt hinter dem Link zur Seite das Datum, an dem die Seite in die zuerst angegebene Kategorie eingeordnet wurde, hinzu. Kann true
, ISO 8601
oder ein aus y
, m
und d
bestehendes Datumsformat sein. Ist standardmäßig false
, das Datum wird also nicht angezeigt.
shownamespace
Legt fest, ob das Namensraumpräfix mit angezeigt werden soll. Ist standardmäßig true
, auf false
setzen, damit das Präfix ausgeblendet wird.
unlink
Auf einen beliebigen Wert außer false
setzen, damit die Seiten nicht verlinkt werden. Nützlich für erweiterte Formatierungen unter Zuhilfenahme von Vorlagen.
suppresserrors
Auf beliebigen Wert setzen, damit Meldungen im Falle eines Fehlers oder einer leeren Ergebnismenge nicht angezeigt werden.
message
Damit kann man eine spezielle Fehlermeldung für eine leere Ergebnismenge definieren. Diese beginnt immer mit intersection_noresults-
und liegt im MediaWiki-Namensraum. Ist dieser Parameter nicht gesetzt, wird MediaWiki:Intersection noresults verwendet.