Extension:DynamicPageList (Wikimedia)/de

Bei dieser Seite handelt es sich um eine Übersetzung der Seite Extension:DynamicPageList in die deutsche Sprache.

DynamicPageList ist eine Erweiterung der Software „Mediawiki 1.5“, die ursprünglich für die Benutzung bei der englischen Version von Wikinews entwickelt wurde, aber auch bei der deutschen Version von Wikinews verwendet wird und welche bei jeder Mediawikiinstallation eingebunden werden kann. Diese Software-Erweiterung erlaubt es Wiki-Benutzern eine Liste von Seiten (z.B. Artikeln) zu erstellen, die in einer Reihe von Kategorien aufgeführt werden. Eine erweiterte Version dieser Erweiterung wird auf der Seite Extension:DynamicPageList2 beschrieben.

Eine Downloadseite für „dynamic page list“ gibt es als SVN unter folgender Adresse: mediawiki/trunk/extensions/intersection/DynamicPageList.php. Zur Installation ist die Datei in das Verzeichnis  zu kopieren und in „LocalSettings.php“ muss die Zeile   hinzugefügt werden.

DynamicPageList benutzen
Die Dynamic Page List (DPL) ist eine MediaWiki-Software-Erweiterung. Um sie zu benutzen, ist folgende XML-ähnliche Syntax auf der entsprechenden Wikiseite einzufügen:

 ...parameters... 

Die Ausgabe eines solchen Codes sähe dann etwa so aus:


 * Seite 1
 * Seite 2
 * Noch eine Seite

Die Eigenschaften dieser Liste, also die Darstellungsform und die Anordnung der ausgegebenen Seiten, erfolgt durch das Festlegen bestimmter Parameter, die dem Ausdruck übergeben werden.

Folgende Liste stellt die einzelnen Parameter und ihre Wirkungsweise vor:

verbindlicher Parameter: category
Zweck:

Gib eine existierende Kategorie an. Beispiel: Wenn du eine Liste erstellen möchtest, die Seiten (Artikel) aus einer bestimmten Kategorie enthält, musst du diese Kategorie als Parameter angeben. Wenn mehr als eine Kategorie angegeben wird, dann werden nur solche Seiten ausgegeben, die in allen genannten Kategorien verlinkt sind.

Syntax:

Anmerkung für die Verwendung in einer deutschsprachigen Umgebung:

Die Bezeichnung „category“ kann nicht in „Kategorie“ übersetzt werden. Es handelt sich um einen festgelegten Ausdruck innerhalb der Software.

Beispiel:

 category=Europäische Politik category=US-Politik 

Dieser Code wird (in der deutschen Wikinews) eine Liste generieren, die Artikel enthält, die sowohl in der als auch in der  auftauchen.

Anmerkungen:

Es muss wenigstens eine Kategorie angegeben werden. Die maximale Anzahl von Kategorien in einer DPL-Schleife kann bei der Installation festgelegt werden (nur wichtig für Systemverwalter).

Solche Vorlagen wie August, 28, 2024 usw. können als Kategoriename verwendet werden. In Kombination mit anderen Kategorien ist aber Vorsicht geboten. Wenn keine Ergebnisse vorhanden sind, wird folgende Fehlermeldung ausgegeben: „DynamicPageList: No results!“

Parameter: notcategory
Zweck:

Es geht bei diesem Parameter darum, dass bestimmte Seiten nicht ausgegeben werden sollen. Ähnlich wie der Kategorieparameter, erfordert aber, dass die Seiten, die hier ausgeschlossen werden sollen, nicht in einer bestimmten Kategorie enthalten sind.

Syntax:

Beispiel:  category=Terrorismusbekämpfung notcategory=US-Politik 

Diese Liste wird alle Seiten mit der ausgeben, dabei aber die Seiten nicht ausgeben, die außerdem die  haben.

Anmerkung: Diese Vorlagen: August, 28, 2024 usw. dürfen als Kategoriename verwendet werden.

Parameter: namespace
Zweck:

Beschränkt die Ausgabe von Artikeln auf einen bestimmten Namensraum.

Syntax:

Die Namensraum-ID kann eine positive ganze Zahl einschließlich Null sein, unter der Voraussetzung, es gibt diesen Namensraum in dem jeweiligen System. Der Namensraum mit der Nr. Null ist der (Haupt-)Artikelnamensraum.

Anstatt der Nummer, kann auch eine korrekte Namensbezeichnung für den Namensraum angegeben werden. Zum Beispiel (in den deutschen Wikinews:) „Diskussion“ oder „Benutzer Diskussion“ oder „Kategorie Diskussion“ oder „Kategorie“ usw. Ein ungültiger Name wird durch den (Haupt-)Namensraum ersetzt.

Syntax:

 category=Deutsche_Politik namespace=(Haupt-) 

Dieser Code gibt eine Liste mit Artikeln aus, die in der aufgelistet sind und im Hauptnamensraum ( = Artikelnamensraum) von Wikinews enthalten sind.

Parameter: shownamespace
Zweck:

Dieser Parameter verhindert die Ausgabe der Namensraum-Bezeichnung. Nützlich zum Beispiel, wenn Kategorien aufgelistet werden sollen, jedoch der Präfix Kategorie: dabei unterdrückt werden soll.

Syntax:

Wenn der Parameter nicht angegeben ist die Grundeinstellung (default):true.

Beispiel:

 shownamespace=false category=Wikinews namespace=Kategorie 

Dieser Code würde (in den deutschen Wikinews) eine Liste mit Kategorien ausgeben, die Unterkategorien der Kategorie:Wikinews sind. Dabei würde der Präfix Kategorie: ... jeweils weggelassen.

Parameter: mode
Zweck:

Hier geht es darum, in welcher Weise (als Aufzählung oder nummerierte Liste) das Ergebnis ausgegeben werden soll:

Syntax:

Für Ausgabemodus ist eine der folgenden Parameter möglich:
 * unordered &mdash; ungeordnete Liste mit Aufzählungszeichen &mdash; HTML-Element "ul" &mdash; (default)
 * ordered &mdash; gibt eine nummerierte Liste aus &mdash; HTML-Element "ol"
 * none &mdash; gibt eine unnummerierte Liste ohne Aufzählungszeichen aus, die einfach nach einem Titel eine neue Zeile erzeugt; sie benutzt das HTML-Element  um jede Ausgabe von der vorangehenden zu trennen.

Beispiel:

 category=!Hauptkategorie mode=ordered 

Diese DPL-Schleife würde eine nummerierte Liste mit den Unterkategorien der Kategorie:!Hauptkategorie der deutschen Wikinews ausgeben, eine &lt;ol&gt;...&lt;/ol&gt; Liste.

Parameter: order
Zweck:

Kontrolliert die Reihenfolge der Einträge in der ausgegebenen Liste.

Syntax:

Nummerierungsrichtung kann eine der beiden folgenden Parameter sein:
 * descending (absteigend) &mdash; sortiert die Liste vom jüngsten zum ältesten Datum &mdash; (default) (Grundeinstellung)
 * ascending (aufsteigend) &mdash; gibt die Liste in umgekehrter Reihenfolge vom ältesten zum neuesten Eintrag aus.

Beispiel:

 category=Deutsche_Politik order=ascending 

Diese DPL-Schleife gibt Seiten der nach ihrem Datum aus. Reihenfolge: vom ältesten zum jüngsten.

Parameter: count
Zweck:

Es handelt sich um einen Zähler, der die Anzahl der ausgegebenen Einträge begrenzt.

Syntax:

Beispiel:

 category=Deutsche_Politik count=10 

Dieses Listing gibt die zehn jüngsten Artikel der Kategorie Deutsche Politik aus.

Bemerkung:

Die maximale Anzahl der ausgegebenen Seiten wird durch die Grundeinstellungen des Systems bei der Installation der Softwareerweiterung festgelegt.

Parameter: ordermethod
Zweck:

Legt fest, welches Datum zur Ordnung der Liste benutzt wird.

Syntax:

Methode kann eine der folgenden sein:
 * categoryadd &mdash; gibt eine Liste aus, die auf der letzten Hinzufügung eines Artikels zu der zuerst genannten Kategorie beruht. &mdash; (default) (Grundeinstellung)
 * lastedit &mdash; gibt eine Liste aus, die den Artikel mit dem zuletzt stattgefundenen Edit zuerst auflistet.

Beispiel:  namespace=0 category=Deutsche_Politik ordermethod=lastedit </DynamicPageList>

Diese DPL-Schleife gibt den Artikel zuerst aus, der zuletzt bearbeitet worden ist. Das Ergebnis liefert eine Artikelliste der Kategorie:Deutsche Politik mit den zuletzt bearbeiteten Artikeln ganz oben.

Parameter: suppresserrors
Zweck:

Erlaubt die Unterdrückung von Fehlermeldungen (bei leeren Listen).

Syntax:

Falls man die Angabe dieses Parameters weglässt, ist die Grundeinstellung: false.

Beispiel:

 category=Nonexistent suppresserrors=true </DynamicPageList>

Dieses Listing liefert kein Ergebnis (auch keine Fehlermeldung), weil die Kategorie nicht existiert.

Parameter: redirects
Zweck:

Ermöglicht die Kontrolle über die Einbeziehung bzw. den Ausschluss von Seiten mit Redirects bei der ausgegebenen Liste.

Syntax:

Unter Kriterien könnte der eine der folgenden Angaben gemacht werden:
 * exclude (ausschließen) &mdash; schließt Redirect Seiten (umgeleitete Seiten) aus &mdash; (default) (Grundeinstellung)
 * include (einschließen) &mdash; erlaubt die Anzeige umgeleiteter Seiten in der ausgegebenen Liste.
 * only &mdash; führt nur Redirect-Seiten in der ausgegebenen Liste auf.

Beispiel:

 category=Afrika redirects=include </DynamicPageList>

Diese Liste wird Seiteninhalte einschließlich von Redirects ausgeben, die in der auftauchen.

Parameter: addfirstcategorydate
Zweck:

Zeigt das Datum, an dem der Artikel zu der ersten in der DPL-Schleife genannten Kategorie hinzugefügt wurde.

Syntax:

oder

Wenn dieser Parameter nicht angegeben wird, ist die Grundeinstellung false.

Beispiel:

 category=Afrika addfirstcategorydate=true </DynamicPageList>

Diese DPL-Schleife gibt eine Liste von Seiten aus, die zur gehören, dabei wird jedem Ergebnis das Datum im Format „TT.MM.JJJJ: “ vorangestellt (Format jeweils entsprechend den Grundeinstellungen).