Hilfe:DPL3/Handbuch

Hilfe:DPL3 → Handbuch

DynamicPageList3 (DPL/DPL3) ist eine leistungsstarke MediaWiki-Erweiterung, die Listen von Seiten und/oder bestimmte Daten und Statistiken, die von ihnen gesammelt wurden, für die Anzeige in einer Wiki-Seite erzeugen kann. DPL-Listen werden automatisch aktualisiert, wenn sich diese Daten ändern.

Als einfaches Beispiel kann DPL verwendet werden, um in eine Wikiseite eine immer aktuelle Liste aller Seiten einer bestimmten Kategorie einzufügen. Die angezeigten Daten können auf der Grundlage von Faktoren wie Autor, Namensraum, Datum, Namensmuster, Verwendung von Vorlagen oder Verweisen auf andere Artikel ausgewählt und sortiert werden, mit einer Vielzahl von benutzerdefinierten Formatierungsmöglichkeiten.

Verwendung

• Allgemeine Verwendung und Aufrufsyntax

Primäre DPL-Module

• Kriterien für die Seitenauswahl
• Steuerung des Ausgabeformats
• Steuerung der Ausgabereihenfolge
• Steuerung der Ausgangsmenge
• Andere Parameter

Vollständiges DPL-Handbuch Inhaltsverzeichnis

Im Folgenden findest du das alte Inhaltsverzeichnis, das in der ursprünglichen DPL-Dokumentation als Navigationshilfe diente. Es handelt sich um eine umfangreiche Liste von DPL-Parametern mit Querverweisen (die manche als einschüchternd und andere als hilfreich empfinden). Die Links können alle über die oben aufgeführten Seiten gefunden werden, aber die Tabelle unten kann nützlich sein, um leichter zu finden, was du brauchst, vor allem, wenn du nicht weißt, in welchem Abschnitt deine gewünschte Funktionalität zu finden ist (erweitere die Tabelle unten und verwende die Funktion „In Seite suchen“ deines Browsers, normalerweise Strg-F).

Steuerung des Ausgabeformats
Name	Zweck
mode	Grundlegende Kontrolle über die Ausgabe von DPL.
inlinetext	Zur Definition des im mode verwendeten Inline-Textes.
listseparators	Alias für format. Stellt implizit mode ein.
format	Das Ausgabeformat vollständig anpassen. Setzt implizit mode ein. Verwendet Variablenreferenzen wie %PAGE%, um das Ausgabeformat zu beschreiben. Siehe auch den Parameter secseparators.
secseparators	Passt das Ausgabeformat der eingeschlossenen Abschnitte an. Kann mit Standard-Ausgabemodi und mit mode verwendet werden.
multisecseparators	Einen Tag zwischen mehrere transkludierte Teile setzen, die sich auf dieselbe Vorlage oder denselben Abschnitt beziehen.
dominantsection	Einen Abschnitt, der mehrfach vorkommt, als dominant definieren, d. h. jeder Inhalt dieses Abschnitts (der mit einem Vorlagenaufruf oder einem Abschnitt im Originaltext verbunden ist) erzeugt eine eigene Ausgabezeile.
table	Eine einfache Syntax zur Erstellung von Standard-Tabellenausgaben; siehe auch tablerow.
tablerow	Eine einfache Syntax zur Erstellung angepasster tabellarischer Ausgaben; siehe auch table.
tablesortcol	Eine Spalte definieren, die als Sortierschlüssel verwendet werden soll (siehe auch table)
headingmode	Zur Steuerung der Ausgabe von Überschriften in einer DPL mit komplexer/mehrparametriger ordermethod. (Keine Auswirkung bei einparametriger Ordnungsmethode.) Bei ordermethod wird method1 für Überschriften verwendet. Z.B. wirkt sich headingmode auf Kategorieüberschriften in ordermethod (2-Param ordermethod) aus. Siehe auch headingcount
headingcount	In Kombination mit headingmode entscheidet dieser Parameter, ob wir eine Textzeile mit der Anzahl der Artikel pro Gruppe anzeigen oder nicht.
listattr	Fügt Attribute zu HTML-Listenelementen hinzu, abhängig von mode (HTML-Element ist <ol> für geordnet, <ul> für ungeordnet, <div> für andere). Kann mit pseudo mode verwendet werden, wenn Inline-Text ein oder mehrere <br/> enthält. Nur anwendbar auf mode = ordered oder mode = unordered. Nicht anwendbar auf mode = category oder mode = inline (ohne <br/> im Inline-Text).
itemattr	Fügt Attribute zu HTML-Listenelementen hinzu, abhängig von mode (Element ist <li> für geordnet/ungeordnet, <span> für andere). Nicht anwendbar auf mode = category.
hlistattr	Fügt Attribute zum HTML-Listenelement auf der Überschriften-/Top-Ebene hinzu, je nach headingmode (HTML-Element wäre <ol> für geordnet, <ul> für unsortiert, <dl> für Definition, <div> für andere) Noch nicht anwendbar auf headingmode = none.
hitemattr	Fügt Attribute zu HTML-Listenelementen (Überschriften) auf der Überschriftsebene hinzu, abhängig von headingmode (HTML-Element wäre <li> für geordnet/ungeordnet, <div> für andere). Zu verwenden mit headingmode = unordered oder headingmode = ordered. (Noch nicht anwendbar für andere.)
userdateformat	Definiert ein spezielles Layout für die Datumsformatierung.
shownamespace	Zur Einschränkung der Anzeige des Namens des Namensraums einer Seite vor der Seite. Da der Schalter standardmäßig auf true steht, sollte er auf false gesetzt werden, wenn du vermeiden willst, dass Namensräume in der Ausgabe angezeigt werden.
escapelinks	In Bezug auf Bilder und Kategorien kannst du mit diesem Parameter entscheiden, ob du einen Link zum Bild oder zur Kategorieseite sehen willst (escapelinks = true, dies ist der Standard) du das Bild sehen willst oder ob die Seite, die die DPL-Anweisung enthält, Teil der Kategorien sein soll, die von DPL zurückgegeben werden (escapelinks = false)
titlemaxlength	Um die Anzahl der anzuzeigenden Zeichen des Titels zu begrenzen. Wenn der Seitentitel (ohne Namensraum oder ein anderes Präfix vor dem Titel) größer ist als der Wert titlemaxlength, wird der Titel abgeschnitten und mit „...“ beendet.
replaceintitle	Eine String-Ersetzungsoperation für die Variable %TITLE% durchführen.
columns	Definiert ein Spaltenlayout für die Ausgabe.
rows	Definiert ein Zeilenlayout für die Ausgabe. Eine „row“ ist eine Gruppe von Ausgabezeilen, für die die Überschrift wiederholt wird. Wenn du nicht weißt, wie groß dein Ergebnis sein wird, ist es vielleicht besser, den Parameter rowsize zu verwenden.
rowsize	Definiert ein Zeilenlayout für die Ausgabe. Eine „row“ ist eine Gruppe von Ausgabezeilen, für die die Überschrift wiederholt wird.
rowcolformat	Definiert Layout-Eigenschaften (unter Verwendung von HTML-Tabellen-Tag Parameter) für das Zeilen-/Spaltengitter.
Steuerung der Ausgabereihenfolge
Name	Zweck
ordermethod	Legt fest, nach welchem Kriterium (bzw. welchen Kriterien) die Liste geordnet wird (bzw. werden).
order	Steuert die Sortierrichtung der Liste.
ordercollation	Erlaubt individuelle Sortierreihenfolge, ermöglicht Sortierung ohne Berücksichtigung von Groß- und Kleinschreibung
Steuerung der Ausgangsmenge
Name	Zweck
resultsheader	Eine Überschrift ausgeben, wenn es mindestens einen Artikel gibt, der angezeigt werden soll.
resultsheader	Eine zusammenfassende Fußzeile ausgeben, wenn mindestens ein Artikel angezeigt werden soll.
oneresultheader	Eine Überschrift ausgeben, wenn es genau einen Artikel gibt, der angezeigt werden soll.
oneresultfooter	Eine Fußzeile ausgeben, wenn es genau einen Artikel gibt, der angezeigt werden soll.
noresultsheader	Eine Überschrift ausgeben, wenn es keinen Artikel gibt, der angezeigt werden soll (leeres Ergebnis).
suppresserrors	Unterdrückt die Warnmeldung, wenn kein passender Artikel gefunden wurde.
noresultsfooter	Gibt eine Fußzeile aus, wenn es keinen Artikel gibt, der angezeigt werden soll (leeres Ergebnis).
addcategories	Zeigt alle Kategorien, zu denen ein Artikel gehört, in einer kleinen Textzeile hinter dem Artikelnamen an.
addpagecounter	Zeigt an, wie oft die Seite gemäß der Definition des Feldes page_counter in Page_table aufgerufen wurde.
addpagesize	Zeigt die Größe der Seite an (in Bytes).
addcontribution	zeigt an, wie viel ein Benutzer zu einem Artikel beigetragen hat.
adduser	Erfordert ordermethod = [...,]firstedit oder ordermethod = [...,]lastedit (wobei das [...,] eine komplexe ordermethod mit zusätzlichen Parametern bedeutet). Wenn firstedit (lastedit), zeigt adduser = true den Benutzer an, der die erste (letzte) Version der Seite erstellt hat. Auf diese Weise ist der Parameter gleichwertig mit dem addauthor (addlasteditor) Parameter (siehe unten).
addauthor	Zeigt den Benutzer, der den Artikel erstellt hat.
addlasteditor	Zeigt den Benutzer an, der die letzte Version einer Seite bearbeitet hat
addpagetoucheddate	Zeigt Datum/Uhrzeit der letzten Änderung an der Seite gemäß der Definition des Feldes page_touched in Page_table. Erfordert ordermethod = [...,]firstedit oder ordermethod = [...,]lastedit (wobei das [...,] eine komplexe ordermethod mit zusätzlichen Parametern bedeutet).
addeditdate	Erfordert ordermethod = [...,]firstedit oder ordermethod = [...,]lastedit (wobei das [...,] eine komplexe ordermethod mit zusätzlichen Parametern bedeutet). Kollisionen mit anderen add*date-Parametern (addpagetoucheddate, usw.).
addexternallink	Gibt die URL eines externen Links in der Ausgabeliste aus.
addfirstcategorydate	Zeigt das Datum/Uhrzeit an, an dem der Artikel zu einer der aufgelisteten include-Kategorien hinzugefügt wurde. Wenn mehr als eine Kategorie aufgeführt ist und ein Artikel zu mehr als einer Kategorie gehört, ist das Ergebnis nicht eindeutig. Aus logischer Sicht ist es empfehlenswert, nur eine Kategorie mit dem Parameter category einzuschließen oder sicherzustellen, dass jeder Artikel im Ergebnis nur zu einer der aufgelisteten Kategorien gehört. Kollisionen mit anderen add*date-Parametern (addpagetoucheddate, usw.).
showcurid	Seitenlinks enthalten die momentane Seiten-ID.
include	Seiten (ganze Inhalte) oder bestimmte Abschnitte von Artikeln oder Vorlagenparametern einschließen. Diese Funktionalität basiert auf den Ideen und der Arbeit von Steve Sanbeg und seiner Erweiterung Labeled Section Transclusion. DPL wird mit einer modifizierten Version von Sanbegs Quellcode ausgeliefert, sodass keine zusätzliche Installation erforderlich ist.
includepage	Dies kann als längerer Name für include verwendet werden.
includemaxlength	Begrenzt die Größe eines eingebundenen Artikels auf maximal [n] Zeichen des Wiki-Quelltextes oder weniger. Es wird darauf geachtet, dass Paare von geschweiften Klammern und Klammern so weit wie möglich eingehalten werden. Andernfalls könnten wir das Ergebnis durch halb abgeschnittene Syntaxelemente von transkludierten Abschnitten verwirren. Daher kann die Ausgabe kürzer oder sogar länger als [n] Zeichen sein.
includetrim	Entfernt alle führenden und abschließenden Leerzeichen aus transkludierten Inhalten.
Andere Parameter
Name	Zweck
updaterules	Definiert einen Satz von Regeln, die ausgeführt werden, um eine Aktualisierung ausgewählter Artikel durchzuführen (Massenaktualisierung oder Bearbeitung von Vorlagenwerten).
deleterules	Ermöglicht die Massenlöschung von Wikiseiten.
goal	Das Gesamtziel für DPL festlegen, um entweder Seiten (Standard) oder Kategorien, zu denen diese Seiten gehören, anzuzeigen.
allowcachedresults	Zwischenspeichern von Abfrageergebnissen, um die Leistung zu verbessern und Serverabstürze bei hoher Belastung zu vermeiden.
reset	Verweise auf Seiten, Vorlagen, Bilder und Kategorien in der DPL-Ausgabe unterdrücken.
fixcategory	Einen Artikel, der eine DPL-Anweisung enthält, einer Kategorie zuordnen, obwohl reset enthält.
eliminate	Verweise auf Seiten, Vorlagen, Bilder und Kategorien in der DPL-Ausgabe unterdrücken.
debug	Legt die Debugging-Stufe fest.
execandexit	Verarbeitet den als Argument angegebenen Befehl und beendet sich dann sofort.
cacheperiod	Die Gültigkeitsdauer für den DPL-Cache festlegen.

Mehr Hilfe

• Ein Stichwortverzeichnis zu verschiedensten Hilfeseiten findest du auf Hilfe:Index.
• Einen geordneten Einstieg zur Hilfe gibt es auf der Seite Hilfe:Übersicht.
• Fragen an andere Benutzer kannst du in den Diskussionen des Community-Wikis stellen.
• Anmerkungen zu dieser Hilfeseite kannst du auf der dazugehörigen Diskussionsseite hinterlassen.
• Um Fehler zu melden, kontaktiere bitte einen Ansprechpartner oder nutze das entsprechende Kontaktformular.