Hilfe:DPL: Unterschied zwischen den Versionen

Aus GuildWiki
Wechseln zu:Navigation, Suche
(Auswahl der Seiten)
Zeile 2: Zeile 2:
  
 
Bei Listen aller Art (momentan aber am wahrscheinlichsten bei Fertigkeitslisten) wird man beim Bearbeiten der Seite auf Abschnitte stoßen, wie  
 
Bei Listen aller Art (momentan aber am wahrscheinlichsten bei Fertigkeitslisten) wird man beim Bearbeiten der Seite auf Abschnitte stoßen, wie  
<pre><DPL>
+
{| width="100%"
   category=...
+
| <pre><DPL>
 +
   category = ...
 
   ...
 
   ...
   allowcachedresults=true
+
   allowcachedresults = true
 
</DPL></pre>
 
</DPL></pre>
Es handelt sich dabei um die ''[[GuildWiki:DPL|Dynamic Page List]]''-Erweiterung, die in der Regel dazu verwendet wird, Seiten in bestimmten Kategorien als formatierte Liste auszugeben.  
+
(Aufruf als Parsererweiterung)
 +
| align="center" | oder
 +
| <pre>{{#dpl:
 +
  | category = ...
 +
  ...
 +
  | allowcachedresults = true
 +
}}</pre>
 +
(Aufruf als Parserfunktion)
 +
|}
 +
 
 +
Es handelt sich dabei um die ''[[GuildWiki:DPL|Dynamic Page List]]''-Erweiterung, die in der Regel dazu verwendet wird, Seiten in bestimmten Kategorien als formatierte Liste auszugeben.
  
 
In dieser Hilfe sollen nur die Grundlagen erklärt werden und ein paar Beispiele, wie man sie im Wiki findet. Falls man darüber hinaus mehr lernen möchte, steht die [http://semeb.com/dpldemo/DPL:Manual (englischsprachige) Anleitung der Erweiterung] zur Verfügung.
 
In dieser Hilfe sollen nur die Grundlagen erklärt werden und ein paar Beispiele, wie man sie im Wiki findet. Falls man darüber hinaus mehr lernen möchte, steht die [http://semeb.com/dpldemo/DPL:Manual (englischsprachige) Anleitung der Erweiterung] zur Verfügung.
 +
 +
==Allgemeine Funktionsweise==
 +
  
 
==Auswahl der Seiten==
 
==Auswahl der Seiten==
Zeile 47: Zeile 61:
  
 
==Formatierungen==
 
==Formatierungen==
 +
{| {{prettytable}}
 +
! Argument
 +
! Beispiel
 +
! Beschreibung
 +
|-
 +
! rowspan="3" style="background:#{{Farbe|Nav|M}}"| mode
 +
| colspan="2" style="background:#{{Farbe|Nav|M}}"| Kontrolliert das generelle Ausgabeformat. Mögliche Werte: '' '''unordered''', '''ordered''', '''none''', '''inline''', '''category''' und '''userformat'''''
 +
|-
 +
|<pre>category=Kategorie1
 +
mode=unordered</pre>
 +
| Einfache '''ungeordnete Liste''' der Seiten in Kategorie1, wie beim HTML-Tag <nowiki><ul></nowiki> oder der Wiki-Syntax mit *. Weiter unterscheiden sich die folgenden Werte nur durch ihre Trennzeichen:
 +
:'' '''ordered''' '' - '''geordnete Liste''', wie beim HTML-Tag <nowiki><ol></nowiki> oder der Wiki-Syntax mit #.
 +
:'' '''none''' '' - getrennt durch einen '''Zeilenumbruch''', wie beim HTML-Tag <nowiki><br /></nowiki>.
 +
:'' '''inline''' '' - Das Trennzeichen in der Liste der Seiten aus Kategorie1 kann über den Parameter '''inlinetext''' selbst gewählt werden.
 +
|-
 +
|<pre>mode=userformat</pre>
 +
| Überlässt die Formatierung der Seiten in der Auswahl anderen Parametern üder die der Benutzer mehr Möglichkeiten zur Gestaltung bekommt.
 +
|}
  
 
[[Kategorie:Hilfe]]
 
[[Kategorie:Hilfe]]

Version vom 21. Januar 2009, 18:10 Uhr

Stub: Stubbeschreibung notwendig oder Stub entfernen!  Stub.png

Bei Listen aller Art (momentan aber am wahrscheinlichsten bei Fertigkeitslisten) wird man beim Bearbeiten der Seite auf Abschnitte stoßen, wie

<DPL>
  category = ...
  ...
  allowcachedresults = true
</DPL>

(Aufruf als Parsererweiterung)

oder
{{#dpl:
  | category = ...
  ...
  | allowcachedresults = true
}}

(Aufruf als Parserfunktion)

Es handelt sich dabei um die Dynamic Page List-Erweiterung, die in der Regel dazu verwendet wird, Seiten in bestimmten Kategorien als formatierte Liste auszugeben.

In dieser Hilfe sollen nur die Grundlagen erklärt werden und ein paar Beispiele, wie man sie im Wiki findet. Falls man darüber hinaus mehr lernen möchte, steht die (englischsprachige) Anleitung der Erweiterung zur Verfügung.

Allgemeine Funktionsweise

Auswahl der Seiten

Argument Beispiel Beschreibung
category Wählt Seiten nach Mitgliedschaft in einer oder mehreren Kategorien aus.
category=Kategorie1|Kategorie2|Kategorie3
ODER-Verknüpfung: Alle Seiten, die in einer der aufgezählten Kategorien vorkommen.
category=Kategorie1&Kategorie2&Kategorie3
oder
category=Kategorie1
category=Kategorie2
category=Kategorie3
UND-Verknüpfung: Alle Seiten, die in allen aufgeführten Kategorien vorkommen. Zum Kombinieren mit der ODER-Verknüpfung muss die zweite Methode verwendet werden.
category=*GuildWiki
Mit * vor der Kategorie werden Seiten in direkten Unterkategorien eingeschlossen. Im Beispiel werden alle Seiten in "GuildWiki" und alle Seiten in einer Unterkategorien von "GuildWiki" gewählt.
notcategory Wählt Seiten die nicht in der angegebenen Kategorieliste vorkommen. Über die UND Verknüpfung mit category kann man so Seiten aus dem Ergebnis von category wieder ausschließen.
category=Kategorie1|Kategorie2
notcategory=Kategorie3
Alle Seiten, die in "Kategorie1" ODER "Kategorie2" sind, aber NICHT in "Kategorie3".
categorymatch
notcategorymatch
Wählt Seiten aus Kategorien, die dem (SQL) Muster entsprechen. % wirkt als Jokerzeichen (steht für beliebig viele beliebige Zeichen).
Aufpassen: Unter Umständen bekommt man mit dieser Methode mehr Ergebnisse als man wünscht (oder unerwartete).
categorymatch=Kategorie%
Alle Seiten, die in "Kategorie1" oder "Kategorie2" oder "Kategorie3" vorkommen und in allen anderen Kategorien, auf die das Muster passt.

Formatierungen

Argument Beispiel Beschreibung
mode Kontrolliert das generelle Ausgabeformat. Mögliche Werte: unordered, ordered, none, inline, category und userformat
category=Kategorie1
mode=unordered
Einfache ungeordnete Liste der Seiten in Kategorie1, wie beim HTML-Tag <ul> oder der Wiki-Syntax mit *. Weiter unterscheiden sich die folgenden Werte nur durch ihre Trennzeichen:
ordered - geordnete Liste, wie beim HTML-Tag <ol> oder der Wiki-Syntax mit #.
none - getrennt durch einen Zeilenumbruch, wie beim HTML-Tag <br />.
inline - Das Trennzeichen in der Liste der Seiten aus Kategorie1 kann über den Parameter inlinetext selbst gewählt werden.
mode=userformat
Überlässt die Formatierung der Seiten in der Auswahl anderen Parametern üder die der Benutzer mehr Möglichkeiten zur Gestaltung bekommt.