Handbuch:Erweiterung/DynamicPageList3: Unterschied zwischen den Versionen

Aktuelle Version vom 28. Juli 2023, 10:25 Uhr

Mit DynamicPageList3 können Sie unter anderem Seitenlisten generieren, die auf jeder Wikiseite angezeigt werden können.Zusätzlich können Sie auch einzelne Seitenabschnitte auf einer Wikiseite transkludieren.

Eine Dokumentation aller Auswahlkriterien und Formatierungsbeispiele sind auf Gamepedia (englisch) erhältlich. Im folgenden sehen Sie einige typische Anwendungsbeispiele. Zusätzlich können Sie eine Tabelle mit einer Liste möglicher Parameter und deren Werte konsultieren.

Seitenabschnitte transkludieren[Bearbeiten | Quelltext bearbeiten]

Um einen Abschnitt einer Seite auf einer anderen Seite anzuzeigen (=transkludieren), geben Sie den Seitennamen (title) und den Abschnittsnamen (include) als Parameter an:

{{#dpl:title=Handbuch:Semantic_MediaWiki|include=#Attribute definieren}}

Unterseiten auflisten[Bearbeiten | Quelltext bearbeiten]

Folgender Code zeigt die Unterseiten der aktuellen Seite in einem 3-spaltigen Layout an:

{{#dpl:
|titlematch={{PAGENAME}}/%
|shownamespace=false
|replaceintitle=/{{PAGENAME}}\//,
|columns=3
|mode=none
|rowcolformat=width=100%
}}

Beispiel: Darstellen der Unterseiten der Seite VisualEditor im Namensraum "Handbuch". Es soll eine 1-spaltige Aufzählungsliste erzeugt werden:

{{#dpl:
|titlematch=Erweiterung/VisualEditor/%  
|shownamespace=false
|namespace=Handbuch 
|replaceintitle=@Erweiterung/VisualEditor/@,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}

Output:

Um die Ausgabe auf die erste Ebene von Unterseiten zu beschränken, kann folgende Anweisung hinzugefügt werden:

|nottitlematch={{PAGENAME}}/%/%

Alternativ-Beispiel:

{{#dpl:
|titlematch=%Performance-Optimierungen/%
|replaceintitle=@Installationsanleitung/Kompendium/Performance-Optimierungen/@,
|namespace=Setup
|shownamespace=false
|includesubpages=true
|mode=unordered
}}

Seiten in bestimmten Namensräumen auflisten[Bearbeiten | Quelltext bearbeiten]

{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}

Output:

Kategorienlayout[Bearbeiten | Quelltext bearbeiten]

<div class="dplcategory">
{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |mode=category
  |ordermethod=titlewithoutnamespace
}}
</div>

Ausgabe:

Falls die Sortierungsbuchstaben am Ende einer Spalte angezeigt werden, kann die Darstellung über Einfügen von css-Deklarationen auf der Seite MediaWiki:Common.css angepasst werden:

/*dpl column layout - avoid header orphans */
.dplcategory {-webkit-column-count:3;column-count:3;}
.dplcategory .mw-category .mw-category-group {display:block}
.dplcategory .mw-category-group {margin:0 2em 2em 2em;}
.dplcategory .mw-category-group h3 {break-after:avoid}
.dplcategory .mw-category-group h3 {margin:0 0 0.3em; border-bottom:1px solid #e2e2e2}

Verbesserte Ausgabe:

Seiten in bestimmten Kategorien auflisten[Bearbeiten | Quelltext bearbeiten]

{{#dpl:
  |category=Bearbeitung
  |addcategories  = true
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
  |mode=ordered  
}}

Output:

Erweiterung/BlueSpiceContextMenu . . Kategorien: Bearbeitung
Erweiterung/BlueSpiceCountThings . . Kategorien: Bearbeitung
Erweiterung/BlueSpiceEmoticons . . Kategorien: Bearbeitung
Erweiterung/BlueSpiceExtendedFilelist . . Kategorien: Bearbeitung
Erweiterung/BlueSpiceFilterableTables . . Kategorien: Bearbeitung

Seiten mit bestimmten Namensmustern[Bearbeiten | Quelltext bearbeiten]

{{#dpl:
 |namespace=Datei
 |titlematch=A%
 |count=5
 }}

Output:

Liste typischer Parameter[Bearbeiten | Quelltext bearbeiten]

Kriterien zur Seitenauswahl[Bearbeiten | Quelltext bearbeiten]

Parameter	Syntax	Beschreibung
category	\|category=Bearbeitung\|Setup...	Seiten aus den Kategorien Bearbeitung ODER Setup
	\|category=Bearbeitung&Setup&...	Seiten aus den Kategorien Bearbeitung UND Setup
	\|category=Bearbeitung\|Setup...\|category=Admin	Seiten aus den Bearbeitung ODER Setup und Seiten aus der Kategorie Admin
notcategory	\|notcategory=Bearbeitung	Seiten, die nicht in der Kategorie Bearbeitung sind
categoriesminmax	\|category=Bearbeitung\|categoriesminmax=2	Seiten, die in der Kategorie Bearbeitung und mindestens 2 weiteren Kategorien sind
	\|category=Bearbeitung\|categoriesminmax=,1	Seiten, die nur in der Kategorie Bearbeitung und in keiner anderen Kategorie sind
namespace	\|namespace=	Seiten im Namensraum (Main)
	\|namespace=Help\|Handbuch	Seiten im Namensraum Help ODER Handbuch
namespacenot	\|namespacenot=Help	Seiten, die nicht im Namensraum Help sind
	\|namespacenot={{NAMESPACE}}	Seiten, die nicht im Namenraum der aktuellen Wikiseite sind

Output-Format[Bearbeiten | Quelltext bearbeiten]

Parameter	Syntax	Beschreibung
mode	\|mode=ordered	Numerierte Liste
	\|mode=unordered	Aufzählungsliste
	\|mode=none	Zeilenumbrüche
	\|mode=category	Seiten werden alphabetisch in A-Z Gruppen formatiert (ähnlicher einer Kategorienseite)
	\|mode=inline\|inlinetext=  •	Seitennamen werden aneinandergereiht mit einem Aufzählungspunkt als Separator

Sortierung[Bearbeiten | Quelltext bearbeiten]

Parameter	Syntax	Beschreibung
ordermethod	\|ordermethod=title	Sortiert nach Seiten(-Präfix+)Titel
	\|ordermethod=titlewithoutnamespace	Sortiert nach Seitenname unabhängig vom Namensraum
	\|ordermethod=counter	Sortiert nach Anzahl der Seitenansichten (Popularität)
	\|ordermethod=size	Sortiert nach Seitengröße
	\|ordermethod=firstedit	Sortiert nach Erstellungsdatum
	\|ordermethod=lastedit	Sortiert nach letztem Bearbeitungdatum
	\|ordermethod=user,firstedit	Sortiert nach Bearbeiter, dann nach Erstellungsdatum durch den Bearbeiter
	\|ordermethod=user,lastedit	Sortiert nach Bearbeiter, dann nach letztem Bearbeitungsdatum durch den Bearbeiter
order	\|order=ascending	Aufsteigend sortiert
	\|order=descending	Absteigend sortiert

Anzeige von Metadaten[Bearbeiten | Quelltext bearbeiten]

Parameter	Syntax	Beschreibung
addcategories	\|addcategories=true	Zeigt alle Kategorien der Seite nach dem Seitennamen an
addpagecounter	\|category:Bearbeitung\|ordermethod=counter\|order=descending \|addpagecounter=true\|count=5	Zeigt die 5 populärsten Seiten aus der Kategorie Bearbeitung
adduser	\|category=Bearbeitung\|ordermethod=lastedit\|adduser=true	Stellt den Seiten den Namen des letzten Bearbeiters voran.
addauthor	\|category=Bearbeitung\|addauthor=true	Stellt den Seiten den Namen des Seitenerstellers voran.

Automatisch generierte DPL3-Kategorien verstecken[Bearbeiten | Quelltext bearbeiten]

Diese Erweiterung erstellt einige, manchmal unerwünschte, automatische Systemkategorien, die dann auf jeder Wiki-Seite angezeigt werden, die eine DPL-Parser-Funktion enthält.

Um diese Kategorien auszublenden:

Gehen Sie in Ihrem Wiki zur Seite Spezial:TrackingCategories
Klicken Sie in der Spalte Name der Nachricht auf dpl-parserfunc-tracking-category
Ersetzen Sie den Text Seiten, die DynamicPageList parser function nutzen‎ durch einen Bindestrich ("-").
Speichern Sie die Seite.

Die Kategorie wird anschließend nicht mehr auf Ihren Wiki-Seiten angezeigt.

Siehe: https://www.mediawiki.org/wiki/Help:Tracking%20categories

Technische Referenz: DynamicPageList3

Feedback zur Dokumentation ist im Community-Forum möglich.

@@ Zeile 1: / Zeile 1: @@
-{{DISPLAYTITLE:Seitenlisten mit DPL3 erstellen}}
+{{DISPLAYTITLE:DPL3: Seitenlisten und Transklusionen}}
-Mit '''DynamicPageList3''' können unter anderem Seitenlisten generiert werden.
+Mit '''DynamicPageList3''' können Sie unter anderem Seitenlisten generieren, die auf jeder Wikiseite angezeigt werden können.Zusätzlich können Sie auch einzelne Seitenabschnitte auf einer Wikiseite transkludieren.
-==Anwendungsbeispiele==
 Eine Dokumentation aller Auswahlkriterien und Formatierungsbeispiele sind auf [https://help.gamepedia.com/Extension:DPL3/Manual Gamepedia] (englisch) erhältlich.
-Im folgenden sehen Sie einige typische Anwendungsbeispiele sowie eine Tabelle mit einer [[Handbuch:Erweiterung/DynamicPageList3#Liste typischer Parameter|Liste möglicher Parameter und deren Werte]].
+Im folgenden sehen Sie einige typische Anwendungsbeispiele. Zusätzlich können Sie eine Tabelle mit einer [[Handbuch:Erweiterung/DynamicPageList3#Liste typischer Parameter|Liste möglicher Parameter und deren Werte]] konsultieren.
-<br />
+==Seitenabschnitte transkludieren==
+Um einen Abschnitt einer Seite auf einer anderen Seite anzuzeigen (=transkludieren), geben Sie den Seitennamen (title)  und den Abschnittsnamen (include) als Parameter an:
+<syntaxhighlight lang="text">
+{{#dpl:title=Handbuch:Semantic_MediaWiki|include=#Attribute definieren}}
+</syntaxhighlight>
+== Unterseiten auflisten ==
-===Unterseiten auflisten===
 Folgender Code zeigt die Unterseiten der aktuellen Seite in einem 3-spaltigen Layout an:<syntaxhighlight lang="text">
 {{#dpl:
@@ Zeile 20: / Zeile 24: @@
 </syntaxhighlight>
+Beispiel: Darstellen der Unterseiten der Seite  ''VisualEditor''  im Namensraum "Handbuch".  Es soll eine 1-spaltige Aufzählungsliste erzeugt werden:<syntaxhighlight lang="text">
-Beispiel: Darstellen der Unterseiten der Seite  ''VisualEditor'' im  im Hauptnamensraum.  Es soll eine 1-spaltige Aufzählungsliste erzeugt werden:<syntaxhighlight lang="text">
 {{#dpl:
-|titlematch=VisualEditor/%
+|titlematch=Erweiterung/VisualEditor/%
 |shownamespace=false
-|namespace=
+|namespace=Handbuch
-|replaceintitle=/VisualEditor\//,
+|replaceintitle=@Erweiterung/VisualEditor/@,
 |columns=1
 |mode=unordered
@@ Zeile 34: / Zeile 36: @@
 </syntaxhighlight>
+<span><span /><span /><span /><span /><span /><br /></span>
 '''Output:'''
 {{#dpl:
-|titlematch=VisualEditor/%
+|titlematch=Erweiterung/VisualEditor/%
 |shownamespace=false
-|namespace=
+|namespace=Handbuch
-|replaceintitle=/VisualEditor\//,
+|replaceintitle=@Erweiterung/VisualEditor/@,
 |columns=1
 |mode=unordered
@@ Zeile 47: / Zeile 49: @@
 }}
+<span><span /><span /><span /><span /><span /><br /></span>
+Um die Ausgabe auf die erste Ebene von Unterseiten zu beschränken, kann folgende Anweisung hinzugefügt werden:<syntaxhighlight lang="text">
+|nottitlematch={{PAGENAME}}/%/%
+</syntaxhighlight>
-===Seiten in bestimmten Namensräumen auflisten===
+<span><span /><span /><span /><span /><span /><br /></span>
+Alternativ-Beispiel:<syntaxhighlight lang="text">
+{{#dpl:
+|titlematch=%Performance-Optimierungen/%
+|replaceintitle=@Installationsanleitung/Kompendium/Performance-Optimierungen/@,
+|namespace=Setup
+|shownamespace=false
+|includesubpages=true
+|mode=unordered
+}}
+</syntaxhighlight>
+== Seiten in bestimmten Namensräumen auflisten ==
 <syntaxhighlight lang="text">
 {{#dpl:
@@ Zeile 59: / Zeile 78: @@
 </syntaxhighlight>
+<span><span /><span /><span /><span /><br /></span>
 '''Output:'''
@@ Zeile 70: / Zeile 89: @@
 }}
-===Seiten in bestimmten Kategorien auflisten===
+<span><br /></span>
+== Kategorienlayout ==
+<syntaxhighlight lang="text">
+<div class="dplcategory">
+{{#dpl:
+  |namespace=Handbuch
+  |includesubpages=true
+  |shownamespace=false
+  |mode=category
+  |ordermethod=titlewithoutnamespace
+}}
+</div>
+</syntaxhighlight>
+<span><span /><span /><span /><br /></span>'''Ausgabe:'''
+[[Datei:DynamicPageList3 categoryoutput.png|alt=Category Format|1091x1091px]]
+Falls die Sortierungsbuchstaben am Ende einer Spalte angezeigt werden, kann die Darstellung über Einfügen von css-Deklarationen auf der Seite ''MediaWiki:Common.css'' angepasst werden:<syntaxhighlight lang="css">
+/*dpl column layout - avoid header orphans */
+.dplcategory {-webkit-column-count:3;column-count:3;}
+.dplcategory .mw-category .mw-category-group {display:block}
+.dplcategory .mw-category-group {margin:0 2em 2em 2em;}
+.dplcategory .mw-category-group h3 {break-after:avoid}
+.dplcategory .mw-category-group h3 {margin:0 0 0.3em; border-bottom:1px solid #e2e2e2}
+</syntaxhighlight>'''Verbesserte Ausgabe:'''
+[[Datei:DynamicPageList3 categoryformatwithcss.png|alternativtext=category Format mit css|1078x1078px]]
+== Seiten in bestimmten Kategorien auflisten ==
 <syntaxhighlight lang="text">
 {{#dpl:
@@ Zeile 83: / Zeile 133: @@
 </syntaxhighlight>
+<span><span /><span /><span /><span /><span /><br /></span>
 '''Output:'''
@@ Zeile 95: / Zeile 145: @@
 |mode=ordered
-}}<br />
+}}<span /><span /><span /><span /><span /><span /><br />
+<span><br /></span>
-===Seiten mit bestimmten Namensmustern===
+== Seiten mit bestimmten Namensmustern ==
 <syntaxhighlight lang="text">
 {{#dpl:
@@ Zeile 108: / Zeile 159: @@
 </syntaxhighlight>
+<span><span /><span /><span /><span /><span /><br /></span>
 '''Output:'''
@@ Zeile 261: / Zeile 312: @@
 |''<nowiki>|category=Bearbeitung|addauthor=true</nowiki>''
 |Stellt den Seiten den Namen des Seitenerstellers voran.
-|}<br />
+|}
+== Automatisch generierte DPL3-Kategorien verstecken ==
+Diese Erweiterung erstellt einige, manchmal unerwünschte, automatische Systemkategorien, die dann auf jeder Wiki-Seite angezeigt werden, die eine DPL-Parser-Funktion enthält.
+[[Datei:DynamicPageList3 dplcategory.png|alternativtext=DPL Tracking Kategorie|zentriert|mini|500x500px]]
+Um  diese Kategorien auszublenden:
+# '''Gehen''' Sie in Ihrem Wiki zur Seite ''Spezial:TrackingCategories''
+# '''Klicken''' Sie in der Spalte ''Name der Nachricht'' auf ''dpl-parserfunc-tracking-category''
+# '''Ersetzen''' Sie den Text ''Seiten, die DynamicPageList parser function nutzen''<span style="color: rgb(37, 37, 37)">‎</span>  durch einen Bindestrich ("-").
+# '''Speichern''' Sie die Seite.
+Die Kategorie wird  anschließend nicht mehr auf Ihren Wiki-Seiten angezeigt.
+<span><span /><span /><span /><span /><span /><br /></span>
+Siehe: https://www.mediawiki.org/wiki/Help:Tracking%20categories
-{{Box Links|Thema1=[[Referenz:DynamicPageList3]]}}<br />
+<span><span /><span /><span /><span /><span /><br /></span>
 [[en:Manual:Extension/DynamicPageList3]]
 [[de:{{FULLPAGENAME}}]]
 [[Category:Organisation]]