Hilfe:DPL3/Parameter: Steuerung der Ausgangsmenge

Achtung: Diese Seite ist möglicherweise nicht mehr auf dem neusten Stand. Besuche Controlling output volume für eine aktuelle Version!

Hilfe:DPL3 → Handbuch → Steuerung der Ausgangsmenge

Standardmäßig zeigt DynamicPageList3 den Namen jedes Artikels an, einschließlich seines Namensraums. Der Name dient als Link zu dem Artikel. Durch Einstellen der Ausgabesteuerungsparameter von DPL kannst du:

• die Anzahl der gefundenen Artikel anzeigen
• den Namensraumteil des Artikelnamens unterdrücken
• die Namen der Artikel ab einer bestimmten Länge abschneiden
• Metadaten hinzufügen (Größe, Autor, letzter Bearbeiter, Datum der letzten Änderung, ...)
• Zugriffsdatum hinzufügen (Häufigkeit, Datum des letzten Zugriffs)
• den Inhalt der Artikel oder Teile davon hinzufügen

Außerdem kannst du eine Überschrift hinzufügen, wenn es einige Artikel gibt, die angezeigt werden sollen.

Und du kannst einen alternativen Text definieren, der angezeigt wird, wenn es keine Artikel gibt, die angezeigt werden sollen.

Definition von Kopf- und Fußzeile für das Ergebnis

resultsheader

resultsheader	Eine Überschrift ausgeben, wenn es mindestens einen Artikel gibt, der angezeigt werden soll.

Syntax

resultsheader = Wikitext

Hinweise:

• Das Zeichen %PAGES% wird durch die Anzahl der gefundenen Seiten ersetzt. Wenn dein Abfrageergebnis begrenzt ist (durch Systemeinstellungen oder durch den Parameter count), zeigt %PAGES% nur die Obergrenze an.
• Das Zeichen %TOTALPAGES% wird durch die Anzahl der gefundenen Seiten ersetzt - unabhängig von den Zählgrenzen. Dies kann zusätzliche Ressourcen verbrauchen.
• %VERSION% wird durch die aktuelle DPL-Version ersetzt.
• Das Symbol \n wird in ein Zeilenumbruchszeichen umgewandelt. Dies ist nützlich, wenn du Wiki-Zeichen verwenden willst, die am Anfang einer Zeile beginnen müssen. Möglicherweise musst du \n hinzufügen, wenn der Wiki-Parser einen Zeilenumbruch benötigt, um deinen Wikitext zu verstehen.
• Wenn auch oneresultheader angegeben ist, wird letzteres verwendet, wenn es genau einen Eintrag in der DPL-Ergebnismenge gibt. Dann wird resultsheader nur verwendet, wenn zwei oder mehr Einträge in der Ergebnismenge vorhanden sind.

Beispiel

{{#dpl:
| category = Afrika
| mode = userformat
| resultsheader = Es gibt %PAGES% Seiten in Afrika.
}}

Mit mode = userformat erhalten wir die vollständige Kontrolle über die Ausgabe. Wir geben listseparators nicht an – also wird nichts außer dem Ergebniskopf angezeigt. Das einzige, was wir erhalten, ist eine Meldung über die vorhandene Anzahl von Artikeln.

resultsfooter

resultsheader	Eine zusammenfassende Fußzeile ausgeben, wenn mindestens ein Artikel angezeigt werden soll.

Syntax

resultsheader = Wikitext

Hinweis: die Regeln aus resultsheader gelten auch hier.

Beispiel

{{#dpl:
| category = Afrika
| mode = userformat
| resultsfooter = \n=== Es gibt %PAGES% Seiten in Afrika. ===\n
}}

Mit mode = userformat erhalten wir die vollständige Kontrolle über die Ausgabe. Wir geben listseparators nicht an – also wird nichts außer der Fußzeile angezeigt. Das einzige, was wir erhalten, ist eine Meldung über die vorhandene Anzahl von Artikeln. Wir haben \n verwendet, um sicherzustellen, dass unsere Überschriftssyntax auch wirklich vom Wikitext-Parser erkannt wird.

oneresultheader

oneresultheader	Eine Überschrift ausgeben, wenn es genau einen Artikel gibt, der angezeigt werden soll.

Syntax

oneresultheader = Wikitext

Hinweis:

• %VERSION% wird durch die aktuelle DPL-Version ersetzt.
• Das Symbol \n wird in ein Zeilenumbruchszeichen umgewandelt. Dies ist nützlich, wenn du Wiki-Zeichen verwenden willst, die am Anfang einer Zeile beginnen müssen. Möglicherweise musst du \n hinzufügen, wenn der Wiki-Parser einen Zeilenumbruch benötigt, um deinen Wikitext zu verstehen.

oneresultfooter

oneresultfooter	Eine Fußzeile ausgeben, wenn es genau einen Artikel gibt, der angezeigt werden soll.

Syntax

oneresultfooter = Wikitext

Hinweis:

• %VERSION% wird durch die aktuelle DPL-Version ersetzt.
• Das Symbol \n wird in ein Zeilenumbruchszeichen umgewandelt. Dies ist nützlich, wenn du Wiki-Zeichen verwenden willst, die am Anfang einer Zeile beginnen müssen. Möglicherweise musst du \n hinzufügen, wenn der Wiki-Parser einen Zeilenumbruch benötigt, um deinen Wikitext zu verstehen.

noresultsheader

noresultsheader	Eine Überschrift ausgeben, wenn es keinen Artikel gibt, der angezeigt werden soll (leeres Ergebnis).

Syntax

noresultsheader = Wikitext

Hinweis: Wenn du noresultsheader auf ein einzelnes Leerzeichen oder einen Zeilenumbruch setzt (noresultsheader =   oder noresultsheader = \n), wird die Warnmeldung von DPL unterdrückt, die normalerweise ausgegeben wird, wenn keine Artikel gefunden wurden.

Beispiel

{{#dpl:
| titlematch = nichtsoeinArtikel
}}

{{#dpl:
| noresultsheader =  
| titlematch = nichtsoeinArtikel
}}

suppresserrors (VERALTET)

Dieser Parameter ist veraltet und wird im Code als Null-Parameter belassen, um den Benutzern Zeit zu geben, ihn aus ihren Abfragen zu entfernen. Er wird in einer zukünftigen Version von DPL vollständig entfernt werden.

suppresserrors	Unterdrückt die Warnmeldung, wenn kein passender Artikel gefunden wurde.

Syntax

suppresserrors = true

Siehe: debug

noresultsfooter

noresultsfooter	Gibt eine Fußzeile aus, wenn es keinen Artikel gibt, der angezeigt werden soll (leeres Ergebnis).

Syntax

noresultsfooter = Wikitext

Hinweis: noresultsfooter ist im Wesentlichen dasselbe wie noresultsheader. Wenn keine Ausgabe angezeigt werden soll, wird der Unterschied zwischen Kopf- und Fußzeile äußerst gering ...

Metadaten zur Ausgabe hinzufügen

addcategories

addcategories	Zeigt alle Kategorien, zu denen ein Artikel gehört, in einer kleinen Textzeile hinter dem Artikelnamen an.

Syntax

addcategories = true

addpagecounter

addpagecounter	Zeigt an, wie oft die Seite gemäß der Definition des Feldes page_counter in Page_table aufgerufen wurde.

Syntax

addpagecounter = true

addpagesize

addpagesize	Zeigt die Größe der Seite an (in Bytes).

Syntax

addpagesize = true

addcontribution

addcontribution	zeigt an, wie viel ein Benutzer zu einem Artikel beigetragen hat.

Syntax

addcontribution = true

adduser

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).

Syntax

adduser = true

addauthor

addauthor	Zeigt den Benutzer, der den Artikel erstellt hat.

Syntax

addauthor = true

addlasteditor

addlasteditor	Zeigt den Benutzer an, der die letzte Version einer Seite bearbeitet hat

Syntax

addlasteditor = true

addpagetoucheddate

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).

Syntax

addlasteditor = true

addeditdate

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.).

Syntax

addeditdate = true

addexternallink

addexternallink	Gibt die URL eines externen Links in der Ausgabeliste aus.

Syntax

addexternallink = true

addfirstcategorydate

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.).

Syntax

addfirstcategorydate = true

showcurid

showcurid	Seitenlinks enthalten die momentane Seiten-ID.

Syntax

showcurid = true

Inhalte aus den Artikeln in die Ergebnismenge aufnehmen

include

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

includepage	Dies kann als längerer Name für include verwendet werden.

includemaxlength

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.

Syntax

includemaxlength = [n]

includetrim

includetrim	Entfernt alle führenden und abschließenden Leerzeichen aus transkludierten Inhalten.

Syntax

includetrim = true; Standardwert ist false.

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 das Support-Team.