Zuletzt bearbeitet vor einem Jahr
von Margit Link-Rodrigue

BlueSpice 4.2 und Handbuch:Erweiterung/DynamicPageList3: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
(Die Seite wurde geleert.)
Markierungen: Geleert 2017-Quelltext-Bearbeitung
 
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
{{DISPLAYTITLE:DPL3: Seitenlisten und Transklusionen}}


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. Zusätzlich können Sie eine Tabelle mit einer [[Handbuch:Erweiterung/DynamicPageList3#Liste typischer Parameter|Liste möglicher Parameter und deren Werte]] konsultieren.
==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===
Folgender Code zeigt die Unterseiten der aktuellen Seite in einem 3-spaltigen Layout an:<syntaxhighlight lang="text">
{{#dpl:
|titlematch={{PAGENAME}}/%
|shownamespace=false
|replaceintitle=/{{PAGENAME}}\//,
|columns=3
|mode=none
|rowcolformat=width=100%
}}
</syntaxhighlight>
Beispiel: Darstellen der Unterseiten der Seite  ''VisualEditor'' im  im Hauptnamensraum.  Es soll eine 1-spaltige Aufzählungsliste erzeugt werden:<syntaxhighlight lang="text">
{{#dpl:
|titlematch=Erweiterung/VisualEditor/% 
|shownamespace=false
|namespace=Handbuch
|replaceintitle=@Erweiterung/VisualEditor/@,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}
</syntaxhighlight>
'''Output:'''
{{#dpl:
|titlematch=Erweiterung/VisualEditor/% 
|shownamespace=false
|namespace=Handbuch
|replaceintitle=@Erweiterung/VisualEditor/@,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}
Um die Ausgabe auf die erste Ebene von Unterseiten zu beschränken, kann folgende Anweisung hinzugefügt werden:<syntaxhighlight lang="text">
|nottitlematch={{PAGENAME}}/%/%
</syntaxhighlight>
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:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}
</syntaxhighlight>
'''Output:'''
{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}
<syntaxhighlight lang="text">
{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=20
  |mode=category
  |ordermethod=titlewithoutnamespace
}}
</syntaxhighlight>
'''Output:'''
{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=20
  |mode=category
  |ordermethod=titlewithoutnamespace
}}
===Seiten in bestimmten Kategorien auflisten===
<syntaxhighlight lang="text">
{{#dpl:
  |category=Bearbeitung
  |addcategories  = true
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
  |mode=ordered 
}}
</syntaxhighlight>
'''Output:'''
{{#dpl:
|category=Bearbeitung
|addcategories  = true
|includesubpages=true
|shownamespace=false
|count=5
|ordermethod=title
|mode=ordered
}}<br />
===Seiten mit bestimmten Namensmustern===
<syntaxhighlight lang="text">
{{#dpl:
|namespace=Datei
|titlematch=A%
|count=5
}}
</syntaxhighlight>
'''Output:'''
{{#dpl:
|namespace=Datei
|titlematch=A%
|count=5
}}
==Liste typischer Parameter==
===Kriterien zur Seitenauswahl===
{| class="wikitable" style="width:100%;"
!Parameter
!Syntax
! style="width:380px;" |Beschreibung
|-
|category
|''<nowiki>|category=Bearbeitung|Setup...</nowiki>''
| style="width:380px;" |Seiten aus den Kategorien Bearbeitung ODER Setup
|-
|
|''<nowiki>|category=Bearbeitung&Setup&...</nowiki>''
| style="width:380px;" |Seiten aus den Kategorien Bearbeitung UND Setup
|-
|
|''<nowiki>|category=Bearbeitung|Setup...|category=Admin</nowiki>''
| style="width:380px;" |Seiten aus den Bearbeitung ODER Setup und Seiten aus der Kategorie Admin
|-
|notcategory
|''<nowiki>|notcategory=Bearbeitung</nowiki>''
| style="width:380px;" |Seiten, die nicht in der Kategorie Bearbeitung sind
|-
|categoriesminmax
|''<nowiki>|category=Bearbeitung|categoriesminmax=2</nowiki>''
| style="width:380px;" |Seiten, die in der Kategorie Bearbeitung und mindestens 2 weiteren Kategorien sind
|-
|
|''<nowiki>|category=Bearbeitung|categoriesminmax=,1</nowiki>''
| style="width:380px;" |Seiten, die nur in der Kategorie Bearbeitung und in keiner anderen Kategorie sind
|-
|namespace
|''<nowiki>|namespace=</nowiki>''
| style="width:380px;" |Seiten im Namensraum (Main)
|-
|
|''<nowiki>|namespace=Help|Handbuch</nowiki>''
| style="width:380px;" |Seiten im Namensraum Help ODER Handbuch
|-
|namespacenot
|''<nowiki>|namespacenot=Help</nowiki>''
| style="width:380px;" |Seiten, die nicht im Namensraum Help sind
|-
|
|''<nowiki>|namespacenot={{NAMESPACE}}</nowiki>''
| style="width:380px;" |Seiten, die nicht im Namenraum der aktuellen Wikiseite sind
|}
===Output-Format===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Beschreibung
|-
|mode
|''<nowiki>|mode=ordered</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Numerierte Liste
|-
|
|''<nowiki>|mode=unordered</nowiki>''
|Aufzählungsliste
|-
|
|<nowiki>|</nowiki>''mode=none''
|Zeilenumbrüche
|-
|
|<nowiki>|</nowiki>''mode=category''
|Seiten werden alphabetisch in A-Z Gruppen formatiert (ähnlicher einer Kategorienseite)
|-
|
|''<nowiki>|mode=inline|inlinetext=&amp;nbsp; &amp;bull; &amp;nbsp;</nowiki>''
|Seitennamen werden aneinandergereiht mit einem Aufzählungspunkt als Separator
|}
===Sortierung===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Beschreibung
|-
|ordermethod
|''<nowiki>|ordermethod=title</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Sortiert nach Seiten(-Präfix+)Titel
|-
|
|''<nowiki>|ordermethod=titlewithoutnamespace</nowiki>''
|Sortiert nach Seitenname unabhängig vom Namensraum
|-
|
|''<nowiki>|ordermethod=counter</nowiki>''
|Sortiert nach Anzahl der Seitenansichten (Popularität)
|-
|
|''<nowiki>|ordermethod=size</nowiki>''
|Sortiert nach Seitengröße
|-
|
|''<nowiki>|ordermethod=firstedit</nowiki>''
|Sortiert nach Erstellungsdatum
|-
|
|''<nowiki>|ordermethod=lastedit</nowiki>''
|Sortiert nach letztem Bearbeitungdatum
|-
|
|''<nowiki>|ordermethod=user,firstedit</nowiki>''
|Sortiert nach Bearbeiter, dann nach Erstellungsdatum durch den Bearbeiter
|-
|
|''<nowiki>|ordermethod=user,lastedit</nowiki>''
|Sortiert nach Bearbeiter, dann nach letztem Bearbeitungsdatum durch den Bearbeiter
|-
|order
|''<nowiki>|order=ascending</nowiki>''
|Aufsteigend sortiert
|-
|
|''<nowiki>|order=descending</nowiki>''
|Absteigend sortiert
|}
===Anzeige von Metadaten===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Beschreibung
|-
|addcategories
|''<nowiki>|addcategories=true</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Zeigt alle Kategorien der Seite nach dem Seitennamen an
|-
|addpagecounter
|''<nowiki>|category:Bearbeitung|ordermethod=counter|order=descending</nowiki>''
''|addpagecounter=true|count=5''
|Zeigt die 5 populärsten Seiten aus der Kategorie Bearbeitung
|-
|adduser
|''<nowiki>|category=Bearbeitung|ordermethod=lastedit|adduser=true</nowiki>''
|Stellt den Seiten den Namen des letzten Bearbeiters voran.
|-
|addauthor
|''<nowiki>|category=Bearbeitung|addauthor=true</nowiki>''
|Stellt den Seiten den Namen des Seitenerstellers voran.
|}
== 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.
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.
Siehe: https://www.mediawiki.org/wiki/Help:Tracking%20categories
[[en:Manual:Extension/DynamicPageList3]]
[[de:{{FULLPAGENAME}}]]
[[Category:Organisation]]

Version vom 8. Februar 2023, 10:13 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.

Anwendungsbeispiele

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

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

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 im Hauptnamensraum. 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

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


Output:

{{#dpl:
  |namespace=Handbuch
  |includesubpages=true
  |shownamespace=false
  |count=20
  |mode=category
  |ordermethod=titlewithoutnamespace
}}


Output:

Seiten in bestimmten Kategorien auflisten

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


Output:

  1. Erweiterung/BlueSpiceContextMenu . . Kategorien: Bearbeitung
  2. Erweiterung/BlueSpiceCountThings . . Kategorien: Bearbeitung
  3. Erweiterung/BlueSpiceEmoticons . . Kategorien: Bearbeitung
  4. Erweiterung/BlueSpiceExtendedFilelist . . Kategorien: Bearbeitung
  5. Erweiterung/BlueSpiceFilterableTables . . Kategorien: Bearbeitung



Seiten mit bestimmten Namensmustern

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


Output:

Liste typischer Parameter

Kriterien zur Seitenauswahl

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

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=&nbsp; &bull; &nbsp; Seitennamen werden aneinandergereiht mit einem Aufzählungspunkt als Separator

Sortierung

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

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

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:

  1. Gehen Sie in Ihrem Wiki zur Seite Spezial:TrackingCategories
  2. Klicken Sie in der Spalte Name der Nachricht auf dpl-parserfunc-tracking-category
  3. Ersetzen Sie den Text Seiten, die DynamicPageList parser function nutzen durch einen Bindestrich ("-").
  4. 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



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

Diskussionen