Help:Extension:ParserFunctions/de

Die Erweiterung ParserFunctions bietet elf zusätzliche Funktionen, um die "Magic words" zu ergänzen, die es in MediaWiki bereits gibt. Alle Funktionen, die diese Erweiterung unterstützt, haben folgende Form:
 *  

#expr
Diese Funktion berechnet einen mathematischen Ausdruck und gibt den errechneten Wert aus.


 *  

Die verfügbaren Operatoren sind rechts aufgelistet, in der Reihenfolge des Rangs. Siehe Hilfe:Rechnen für nähere Details über die Funktion der einzelnen Operatoren. Genauigkeit und Format des ausgegebenen Ergebnisses hängen vom Betriebssystem des Wikiservers sowie dem Zahlenformat der eingestellten Sprache ab.

Bei Nutzung der Booleschen Algebra ergibt 0 immer falsch und jeder andere Wert, ob positiv oder negativ, immer wahr:


 *   → 
 *   → 

Ein leerer eingegebener Ausdruck erzeugt eine leere Ausgabe. Ungültige Ausdrücke erzeugen verschiedene Fehlermeldungen (welche durch Nutzung der Funktion #iferror abgefangen werden können):


 *   →  
 *  </tt> → 
 *  </tt> → 

#if

 *  </tt>

Diese Funktion überprüft, ob der eingegebene Ausdruck nicht leer ist. Sie gibt falsch aus, wenn der eingegebene Ausdruck leer ist oder nur Leerzeichen und Zeilenumbrüche enthält.


 *  </tt> → 
 *  </tt> → 
 *  </tt> → 
 *  </tt> → 

Der eingegebene Ausdruck wird nur als reiner Text gewertet, mathematische Ausdrücke werden nicht berechnet.


 *  </tt> → 
 *  </tt> → 

Es können auch Parameter weggelassen werden:


 *  </tt> →  
 *  </tt> →  
 *  </tt> →  

Siehe Help:Parser functions in templates/de für weitere Beispiele zu dieser Funktion.

#ifeq
Diese Funktion vergleicht zwei Ausdrücke und ermittelt, ob sie gleich sind.


 *  </tt>

Wenn beide Ausdrücke einen gültigen Zahlenwerte ergeben, werden die Ergebnisse verglichen:


 *  </tt> → 
 *  </tt> → 
 *  </tt> → 
 * <tt> </tt> → 

Ansonsten wird der Text verglichen. Dabei wird auf Groß- und Kleinschreibung geachtet:


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

#iferror
Diese Funktion überprüft, ob der eingegebene Ausdruck einen Fehler erzeugt. Die Funktion gibt <tt>wahr</tt> aus, wenn der Ausdruck ein HTML-Objekt mit <tt>class="error"</tt> enthält, wie es z.B. von den Funktionen <tt>#expr</tt>, <tt>#time</tt> und <tt>#rel2abs</tt> bei Fehlern ausgegeben wird. Auch Vorlagenfehler wie Rekursionsschleifen werden erkannt.


 * <tt> </tt>

Die Ausgabe-Parameter können auch weggelassen werden. Wenn der Parameter für "kein Fehler" weggelassen wird, wird der zu überprüfende Ausdruck ausgegeben, sofern er keinen Fehler enthält. Wenn der Ausdruck für "Fehler" ebenfalls weggelassen wird, wird bei einem Fehler nichts ausgegeben.


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → &zwnj;
 * <tt> </tt> → 

#ifexpr
Diese Funktion berechnet einen mathematischen Ausdruck und gibt – abhängig vom Wahrheitswert des Ergebnisses – einen von zwei Werten aus.


 * <tt> </tt>

Für den Ausdruck gelten dabei dieselben Regeln wie bei <tt>#expr</tt>. Nach der Berechnung überprüft die Funktion, ob das Ergebnis ungleich Null ist.


 * <tt> </tt> → 
 * <tt> </tt> → 

Eine leere Eingabe führt zur Ausgabe <tt>falsch</tt>:


 * <tt> </tt> → 

Wie gesagt führt das Ergebnis Null zur Ausgabe <tt>falsch</tt>, jeder andere Wert hingegen zur Ausgabe <tt>wahr</tt>. Es handelt sich also praktisch um eine Kombination von <tt>#ifeq</tt> und <tt>#expr</tt>:


 * <tt> </tt>

wobei <tt>#ifexpr</tt> auch leere oder fehlerhafte Ausdrücke verarbeitet und als ungleich Null interpretiert.

Die Funktion wertet auch Gleichungen und Ungleichungen aus:


 * <tt> </tt> → 
 * <tt> </tt> → 

Die Parameter können auch weggelassen werden, in diesem Fall wird nichts ausgegeben:


 * <tt> </tt> → 
 * <tt> </tt> →  
 * <tt> </tt> →  
 * <tt> </tt> →  
 * <tt> </tt> →  

#ifexist
Diese Funktion überprüft, ob eine bestimmte Seite im Wiki existiert, und gibt je nachdem einen von zwei Parametern aus.


 * <tt> </tt>

Die Funktion überprüft nur, ob die Seite existiert, und nicht, ob sie irgendeine Form von Inhalt enthält. Auch Weiterleitungen werden als existente Seiten gewertet. Gelöschte Seiten gelten als nicht existent.


 * <tt> </tt> → 
 * <tt> </tt> → 

MediaWiki-Systemnachrichten gelten so lange als nicht existent, bis sie bearbeitet werden. Auch die Existenz von Spezialseiten kann überprüft werden.


 * <tt> </tt> → 
 * <tt> </tt> →
 * <tt> </tt> →

<tt>#ifexist:</tt> wird als "aufwändige Funktion" eingestuft, von denen nur eine begrenzte Anzahl auf jeder Seite eingesetzt werden können (einschließlich Nutzungen in eingebundenen Vorlagen). Wenn diese Grenze überschritten wird, wird die Seite automatisch in die Kategorie: eingeordnet, und jede überzählige Einbindung von <tt>#ifexist:</tt> ergibt stets <tt>falsch</tt>.

Wenn eine Seite A die Existenz einer Seite B mittels <tt>#ifexist:</tt> überprüft, taucht Seite A auf der Spezialseite |Links auf diese Seite für Seite B auf. Wenn also im Artikel <tt>Bla</tt> der Code <tt> </tt> steht, wird auf Spezial:Linkliste/Blubb die Seite <tt>Bla</tt> aufgelistet.

In Wikis, die eine gemeinschaftliche Bilddatenbank nutzen (z.B. Wikimedia Commons), kann <tt>#ifexist:</tt> benutzt werden, um zu überprüfen, ob Dateien im lokalen Wiki oder in der externen Bilddatenbank hochgeladen wurden.
 * <tt> </tt>  → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Wenn die lokale Bildbeschreibungsseite angelegt wurde, ist das Resultat für all diese Tests <tt>existiert</tt>.

#rel2abs
Diese Funktion wandelt einen relativen Dateipfad in einen absoluten um.


 * <tt> </tt>
 * <tt> </tt>

Bei der Pfadeingabe kann folgende Syntax genutzt werden:
 * → aktuelles Verzeichnis
 * → übergeordnetes Verzeichnis
 * → Unterverzeichnis blubb

Wenn der Grundpfad nicht angegeben wird, wird stattdessen der Name der aktuellen Seite verwendet.

Funktionsbeispiele:


 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''

Mehr als zwei Punkte sind nicht erlaubt. Für ausführlichere Strukturen ist folgende Vorgehensweise möglich:


 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''

#switch
Diese Funktion vergleicht einen eingegebenen Ausdruck mit mehreren möglichen Fällen, und gibt bei einer Übereinstimmung ein Ergebnis aus.

Beispiel:


 * <tt> </tt> →   
 * <tt> </tt> →   
 * <tt> </tt> →   

<tt> #switch </tt> erlaubt es also, in einer Vorlage bestimmte Informationen zu speichern, und diese bei Aufruf wiederzugeben.

Standardausgabe
Die Standardausgabe wird ausgegeben, wenn keine eingetragene Möglichkeit mit dem eingegebenen Ausdruck übereinstimmt. Sie muss stets als letzter Parameter eingetragen werden und darf kein Gleichheitszeichen enthalten. Bei Missachtung wird nichts ausgegeben:


 * <tt> </tt> →   
 * <tt> </tt> →   

Wahlweise kann die Standardausgabe auch mit <tt>#default =</tt> gekennzeichnet werden.

In diesem Fall kann die Standardausgabe auch an jeder Stelle der Funktion stehen:


 * <tt> </tt> →   

Wenn keine Standardausgabe festgelegt ist, wird nichts ausgegeben:


 * <tt> </tt> →   

Möglichkeiten zusammenfassen
Wenn bei mehreren Möglichkeiten die gleiche Ausgabe erfolgen soll, reicht es, den Ausgabetext bei der letzten dieser Möglichkeiten anzugeben:

In diesem Fall ergäben die Möglichkeiten 2, 3 und 4 allesamt die Ausgabe B und die Möglichkeiten 6 und 7 beide die Ausgabe D.

Verhalten beim Vergleichen
As with <tt>#ifeq</tt>, the comparison is made numerically if both the comparison Ausdruck and the case Ausdruck being tested are numeric; or as a case-sensitive Ausdruck otherwise:


 * <tt> </tt> → 
 * <tt> </tt> → 


 * <tt> </tt> → 
 * <tt> </tt> → 

A <tt>case</tt> Ausdruck may be empty:
 * <tt> </tt> → 

Once a match is found, subsequent <tt>cases</tt> are ignored:
 * <tt> </tt> → 

Gleichheitszeichen
Die Vergleichsparameter dürfen keine Gleichheitszeichen enthalten. Um dies zu umgehen kann eine Vorlage = angelegt werden, die einzig und allein ein <tt>=</tt> enthält.

"Beweis":


 * <tt> </tt> → 

Ein einfaches Anwendungsbeispiel findet sich in der Vorlage NBA color, ein komplizierteres in der Vorlage Extension.

#time
Diese Funktion liest ein Datum und/oder eine Zeitangabe (im Gregorianischen Kalender) ein und formatiert es gemäß der angegebenen Syntax. Das Datum/die Zeitangabe kann eingestellt werden, die Voreinstellung ist der Wert des Magic Word <tt> </tt>, also dem Zeitpunkt, als die Seite zuletzt in HTML gerendert wurde.


 * <tt> </tt>
 * <tt> </tt>

Die Liste der möglichen Formatangaben ist in der Tabelle rechts dargestellt. Kann ein Zeichen der Formatangabe nicht erkannt werden, wird es unverändert ausgegeben – dies gilt auch für Leerzeichen. Es gibt auch zwei Möglichkeiten, Zeichen von der Interpretation auszuschließen: Außerdem wird <tt>xx</tt> als einfaches "x" interpretiert.
 * 1) Zeichen, die mit einem Backslash versehen werden, werden unverändert ausgegeben.
 * 2) Zeichen in doppelten oberen Anführungszeichen werden, ohne die Anführungszeichen, unverändert ausgegeben.


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Die eingegebene Zeitangabe kann in jedem Format stehen, welches von der PHP-Funktion strtotime akzeptiert wird. Sowohl absolute (z. B. <tt>20 December 2000</tt>) als auch relative Angaben (z. B. <tt>+20 hours</tt>) werden akzeptiert.

<tt> </tt> → '''

<tt> </tt> → '''

<tt> </tt> → '''

Wenn man einen Unix-Zeitstempel erzeugt hat, kann man ihn in Datumsberechnungen verwenden, indem man ein <tt>@</tt> davorsetzt.

<tt> </tt> → '''

<tt> </tt> → '''

Daten können vollständig oder unvollständig eingegeben werden. Die Funktion füllt die nicht angegebenen Teile mit den aktuellen Werten:


 * <tt> </tt> → '''

Eine vierstellige Zahl wird, wenn möglich, als Stunden und Minuten interpretiert, ansonsten als Jahreszahl:

<tt> </tt> → '''

<tt> </tt> → '''

Eine sechsstellige Zahl wird stets als Stunden, Minuten und Sekunden interpretiert. Bei unpassenden Zahlen erscheint eine Fehlermeldung.

<tt> </tt> → '''

<tt> </tt> → '''

Außerdem gibt es einige Sonderfälle:


 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''
 * <tt> </tt> → '''

Die Gesamtzahl der auf einer Seite in  eingegebenen Zeichen ist auf 6000 beschränkt. 

#timel
Diese Funktion ist identisch mit <tt> </tt>, mit dem Unterschied, dass sie die lokale Zeit des Wikis verwendet, die in $wgLocaltimezone eingestellt ist.


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

#titleparts
Diese Funktion zerteilt einen Seitennamen an Schrägstrichen in Abschnitte und gibt einen ausgewählten Abschnitt aus.


 * <tt> </tt>

Wenn der Parameter für die Anzahl der auszugebenden Abschnitte nicht angegeben wird, wird der komplette Seitenname ausgegeben. Wenn der Parameter für den ersten auszugebenden Abschnitt nicht angegeben wird, wird dafür der erste Abschnitt gewählt:


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Für beide Parameter können auch negative Werte angegeben werden. Ein negativer Wert für die Anzahl der Abschnitte lässt Abschnitte am Ende des Seitennamens abschneiden. Ein negativer Wert für den ersten Abschnitt lässt Abschnitte vom Ende ausgeben:


 * <tt> </tt> → 
 * <tt> </tt> →  
 * <tt> </tt> →  
 * <tt> </tt> →  

Zugelassen sind bis zu 25 Abschnitte, weitere Schrägstriche werden ignoriert. Es gilt die Grenze von 255 Zeichen, wie sie für Seitennamen gültig ist.


 * <tt> </tt> → 


 * <tt> </tt> → 
 * <tt> </tt> → 
 * <tt> </tt> → 

Substituieren
ParserFunctions können genau wie Vorlagen mit <tt> </tt> substituiert werden, das heißt, ihre Ausgabe wird direkt in den Quellcode geschrieben und ist fortan „unabhängig“.


 * <tt> </tt> → der Text <tt>    </tt> wird in den Quellcode eingesetzt, da  existiert.

Tabellen
ParserFunctions zerstören enthaltene Wiki-Tabellen, da die senkrechten Striche | statt als Spalten-/Zeilentrenner als Parameter-Trennzeichen missverstanden werden. Zur Vermeidung gibt es zwei Strategien:

→
 * In den meisten Wikis existiert die Vorlage <tt> | </tt> für <tt>|</tt>, eventuell zusätzlich die Vorlagen <tt> |- </tt> für <tt>|-</tt>, <tt> {| </tt> für <tt>{|</tt> und <tt> |} </tt> für <tt>|}</tt>. Sie „verstecken“ den senkrechten Strich vor dem Parser.
 * Man kann HTML-Tabellencode verwenden: <tt>

Leerräume in Parametern
Leerzeichen, Tabulatoren und Zeilenumbrüche werden bei der Eingabe von Parametern in jedweder Funktion ignoriert. Im Falle, dass das Gegenteil gewünscht ist, können Anführungszeichen verwendet werden:





Wenn bei den Ausgabeparametern Leeräume vor dem Entfernen bewahrt werden sollen, ist die Vorlage If (englisch) zu verwenden.

Siehe auch

 * Hilfe:ParserFunctions in Vorlagen
 * Hilfe:Zeilenumbrüche und Leerzeichen
 * Hilfe:Syntaxvergleich zwischen ParserFunctions und TeX
 * Hilfe:Magic words
 * Erweiterung:StringFunctions