Hilfe:Vorlagenprogrammierung
Demzufolge ist es möglich, daß der Inhalt in Gänze oder in Teilen nicht mit den Kriterien der Metapedia übereinstimmt und Neusprech nach der gegenwärtigen politischen Korrektheit oder sogar neobolschewistisches Gedankengut enthält.
Der Artikel kann hier bearbeitet werden, damit diese Markierung wieder entfernt werden kann.
Seit Mitte April 2006 verfügt die Wiki-Syntax der MediaWiki-Software über verschiedene Konstrukte einer Programmiersprache für die Verwendung in Vorlagen. Voraussetzung ist die Extension ParserFunctions.
(Auch die Grundfunktionalität bringt bereits einen Satz von Parserfunktionen mit sich; diese werden separat unter Hilfe:Variablen#Funktionen beschrieben.)
Die Sprachkonstrukte sollten ausschließlich im Vorlagen-Namensraum verwendet und wohlüberlegt eingesetzt werden. Nicht jede Spielerei, die möglich ist, ist auch sinnvoll. Programmierkonstrukte, die nicht ausreichend dokumentiert sind, werden wieder gelöscht.
Bei Problemen und Fragen zur Vorlagenprogrammierung hilft die Werkstatt des Wikiprojekts Vorlagen weiter.
Inhaltsverzeichnis
Beschreibung der ParserFunctions
Funktion if
Die if
-Funktion ist ein Wenn-Dann-Sonst-Konstrukt. Die Syntax:
{{#if: <Bedingung> | <Dann-Text> | <Sonst-Text>}}
Enthält die <bedingung>
Text, gilt sie als erfüllt und es wird <dann-text>
zurückgegeben. Ist <bedingung>
hingegen leer oder besteht ausschließlich aus Leerzeichen (whitespace), gilt sie als nicht erfüllt und es wird <sonst-text>
zurückgegeben. <sonst-text>
kann auch weggelassen werden, dann wird in diesem Fall nichts zurückgegeben.
Bei der Testbedingung ist auf folgendes zu achten: Wird zum Beispiel der Parameter {{{foo}}}
referenziert und wurde dieser Parameter nicht angegeben, so hat der referenzierte Parameter den Wert „{{{foo}}}
“ (die Wiki-Software löst den Parameter also nicht auf) und der Ausdruck ist immer richtig. Um dies zu verhindern, wird typischerweise {{{foo|}}}
benutzt, also die Angabe eines leeren Default-Wertes. In diesem Fall hat der referenzierte Ausdruck den Wert "", enthält also keinen Text (womit die Bedingung nicht erfüllt ist und der "Sonst-Text" zur Anwendung gelangt). Dieses Verfahren erlaubt allerdings keine Unterscheidung mehr zwischen einem nicht angegebenen oder einem leer angegebenen Parameter.
Da Bedingungen sehr häufig in Tabellen und Infoboxen verwendet werden, noch ein weiterer Hinweis zur Tabellenverarbeitung: Um eine Tabellenzeile auszublenden, die etwa folgenden statischen Aufbau hat
... |- | Name || Wert ...
kann folgende Kodierung verwendet werden
... |- {{#if: {{{foo|}}} | {{!}} Name {{!!}} Wert }} ...
Dabei ist auf folgendes zu achten:
- Innerhalb der if-Anweisung darf das |-Zeichen nicht anderweitig verwendet werden, weil es sonst fälschlicherweise als
dann-text
interpretiert werden würde. Daher muss das für die Tabelle notwendige |-Zeichen als{{!}}
oder doppelt als{{!!}}
kodiert werden. - Die Tabellensyntax erlaubt mehrere leere Zeilen hintereinander. Das heißt, es ist unproblematisch mehrere Zeilen mit
|-
(selbst mit Leerzeilen dazwischen) hintereinander zu kodieren.
Achtung: if
unterstützt keine Gleichungen oder Ähnliches. Siehe dafür ifeq
und ifexpr
.
Funktion ifeq
ifeq
vergleicht zwei Zeichenketten und gibt je nach Ergebnis verschiedene Texte zurück.
{{#ifeq: <Text 1> | <Text 2> | <Text, wenn gleich> | <Text, wenn ungleich> }}
Funktion ifexist
ifexist
prüft, ob ein angegebenes Lemma existiert, und gibt je nachdem verschiedene Texte zurück.
{{#ifexist: <Lemma> | <Text, wenn Lemma existiert> | <Text, wenn Lemma nicht existiert> }}
Dabei darf die Gesamtzahl der ifexist auf einer Seite nicht die Grenze von 500 übersteigen, wobei es egal ist, ob sie eingebunden werden oder nicht. Weitere Einbindungen von ifexist werden stets so behandelt, als würde die angegebene Seite nicht existieren. Zusätzlich erscheint eine Warnung und die Seiten werden kategorisiert.
Die Überprüfung mittels #ifexist:
erzeugt intern einen Link zum überprüften Lemma, dieser taucht dann in dessen Linkliste auf (Bug 12019). Bei Dateien mit Namensraum „Media“ wird eine Verwendung angezeigt. Diese Problematik kann nicht umgangen werden.
Interwiki-Links werden nicht geprüft. Es wird immer angenommen, dass Lemmata in anderen Wikis nicht existieren.
Die Parserfunktion prüft bei Bildern mit Namensraum „Datei“, „File“, „Bild“ oder „Image“ auf Existenz einer Dateibeschreibungsseite im lokalen Projekt, bei Angabe von „Media“ auf physikalische Existenz der Datei, auch über das lokale Projekt hinweg auf Commons.
Um bei einer Datei festzustellen, ob sie von Commons eingebunden wird, kann die Vorlage:IsCommons benutzt werden.
Funktion expr
expr berechnet mathematische Ausdrücke.
{{ #expr: <ausdruck> }}
Operator | Operation | Beispiel |
---|---|---|
Algebraische Operationen | ||
+ | Addition | {{#expr: 30 + 7 }} = 37 |
- | Subtraktion (oder Negation) | {{#expr: 30 - 7 }} = 23 |
* | Multiplikation | {{#expr: 30 * 7 }} = 210 |
/ oder div | Division | {{#expr: 30 / 7 }} = 4.2857142857143 |
^ | Potenz (<math>a^b</math>). Achtung: Beim zweifachen Potenzieren sollten Klammern angegeben werden. Die Potenzen werden von der Software linksassoziativ ausgeführt: 2^2^2 = (2^2)^2. Mit der Beziehung <math>\sqrt[n]{x} = x^{\frac{1}{n}}</math> kann man auch radizieren. | {{#expr: 2^8 }} = 256 |
mod | Modulo, der Rest einer Division | {{#expr: 30 mod 7 }} = 2 |
exp | Exponentialfunktion (<math>e^n</math>) | {{#expr: exp 5 }} = 148.41315910258 |
ln | Der natürliche Logarithmus einer Zahl. Zur Umrechnung in andere Logarithmen siehe Basisumrechnung. | {{#expr: ln exp 3 }} = 3 |
abs | Betragsfunktion | {{#expr: abs -1.2 }} = 1.2, {{#expr: abs 1.2 }} = 1.2 |
Runden | ||
round | Rundet die Zahl auf der linken Seite auf die Anzahl Nachkommastellen, die von der Zahl auf der rechten Seite angegeben wird (kaufmännische Rundung) | {{#expr: 30 / 7 round 7 }} = 4.2857143 |
trunc | Rundet eine Zahl in Richtung Null auf die nächste Ganzzahl, d. h. negative Zahlen werden aufgerundet und positive Zahlen werden abgerundet | {{#expr: trunc -1.2 }} = -1, {{#expr: trunc 1.2 }} = 1 |
floor | Abrunden auf die nächste Ganzzahl | {{#expr: floor -1.2 }} = -2, {{#expr: floor 1.2 }} = 1 |
ceil | Aufrunden auf die nächste Ganzzahl | {{#expr: ceil -1.2 }} = -1, {{#expr: ceil 1.2 }} = 2 |
Konstanten und trigonometrische Operatoren | ||
e | Die Eulersche Zahl e | {{#expr: e }} = 2.718281828459 |
pi | Die Kreiszahl <math>\pi</math> | {{#expr: pi }} = 3.1415926535898 |
sin | Berechnet den Sinus einer Zahl in Bogenmaß | {{#expr: sin 3.14 }} = 0.0015926529164868 |
cos | Berechnet den Kosinus (engl. cosine) einer Zahl in Bogenmaß | {{#expr: cos pi }} = -1 |
tan | Berechnet den Tangens einer Zahl in Bogenmaß | {{#expr: tan 1 }} = 1.5574077246549 |
asin | Berechnet den Arkussinus | {{#expr: asin 0.5 }} = 0.5235987755983 |
acos | Berechnet den Arkuskosinus | {{#expr: acos 0 }} = 1.5707963267949 |
atan | Berechnet den Arkustangens | {{#expr: atan 1.4 }} = 0.95054684081208 |
Vergleichsoperatoren | ||
= | Gleichheit | {{#expr: 30 = 7 }} = 0 |
<> oder != | Ungleichheit | {{#expr: 30 <> 7 }} = 1 |
< | Kleiner als | {{#expr: 30 < 7 }} = 0 |
> | Größer als | {{#expr: 30 > 7 }} = 1 |
<= | Kleiner oder gleich | {{#expr: 30 <= 7 }} = 0 |
>= | Größer oder gleich | {{#expr: 30 >= 7 }} = 1 |
Logische Operatoren | ||
and | Logisches UND | {{#expr: 30 and 7 }} = 1 |
or | Logisches ODER | {{#expr: 30 or 7 }} = 1 |
not | Logisches NICHT | {{#expr: not 7 }} = 0 |
Syntax | ||
#.#e±# | Statt eines Kommas muss der Punkt zur Trennung der Nachkommastellen benutzt werden. Zahlengruppierungen (im deutschen meist der Punkt) sind nicht möglich. Zahlen können in der wissenschaftlichen Notation übergeben werden. Für positive Exponenten ist das Plus optional. | {{#expr: 0.7e4 }} = 7000 |
( ) | Gruppierung/Klammerung | {{#expr: (30 + 7) * 7 }} = 259 |
Hyperbolische, andere trigonometrische, Arkus- und Areafunktionen müssen mit Hilfe der entsprechenden Definitionen und Umrechnungen realisiert werden.
Die booleschen Operatoren behandeln 0 (Null) als falsch und 1 als wahr. Zahlen werden mit dem Punkt als Dezimaltrenner angegeben.
Beispiel:
{{ #expr: (100 - 32) / 9 * 5 round 0 }}
ergibt:
38
Damit werden 100 Fahrenheit auf die Celsius-Skala umgerechnet (auf die nächste Ganze Zahl gerundet).
Da diese Berechnungen aus Kompatibilitätsgründen mit dem englischen Zahlenformat durchgeführt werden (Beispiel: {{ #expr: 13000 / 3.1 round 2 }}
ergibt 4193.55) müssen solche Zahlen zusätzlich in das im deutschen Sprachraum übliche Format umgewandelt werden (Beispiel: {{
formatnum: {{ #expr: 13000 / 3.1 round 2 }} }}
ergibt 4.193,55).
Funktion ifexpr
ifexpr
wertet einen mathematischen Ausdruck aus.
{{#ifexpr: <ausdruck> | <dann-text> | <sonst-text> }}
Ist das Ergebnis von <ausdruck>
0 (Null), wird <sonst-text>
zurückgegeben. Sonst wird <dann-text>
zurückgegeben. <sonst-text>
kann auch weggelassen werden, dann wird in diesem Fall nichts zurückgegeben.
Die Syntax für Ausdrücke wird in der Beschreibung von expr erklärt.
Funktion iferror
iferror
prüft, ob ein Fehler vorliegt, und gibt je nachdem verschiedene Texte zurück. Ein Fehler wird über die Klasse class="error"
repräsentiert. Diese Klasse wird in den Elementen div
, span
, p
und strong
erkannt. Dies ist ein Fehler, wie er bei #expr, #ifexpr, #time oder #rel2abs auftreten kann. Es können so auch vom Benutzer selber Fehler erzeugt werden. Es muss nur die Klasse in einem der Elemente auftauchen.
Die Syntax:
{{#iferror: <Ausdruck> | <Text bei Fehler> | <Text bei keinem Fehler> }}
Die letzten beiden Parameter sind optional. Sofern kein Text bei keinem Fehler angegeben ist, wird Ausdruck zurückgegeben. Ist nur Ausdruck angegeben, wird bei einem Fehler nichts ausgegeben, sonst Ausdruck.
Beispiele:
{{#iferror: <Ausdruck> | <Text bei Fehler> | <Text bei keinem Fehler> }}
Bei einem Fehler im Ausdruck wird Text bei Fehler angezeigt, ansonsten wird Text bei keinem Fehler angezeigt.
{{#iferror: <Ausdruck> | <Text bei Fehler> }}
Bei einem Fehler im Ausdruck wird Text bei Fehler angezeigt, ansonsten der fehlerfreie Ausdruck.
{{#iferror: <Ausdruck> }}
Bei einem Fehler im Ausdruck wird nichts angezeigt, die Fehlermeldung wird unterdrückt.
{{#iferror: {{#expr: 1*{{{Para|}}}}} | Keine Zahl | Zahl }}
Ist {{{Para}}} eine Zahl (man kann also mit 1 multiplizieren) wird „Zahl“ ausgegeben, sonst „Keine Zahl“.
Funktion switch
switch
vergleicht einen Wert mit mehreren anderen. Die Grundsyntax ist:
{{#switch: <vergleichswert> | <wert1> = <ergebnis1> | <wert2> = <ergebnis2> | ... | <wertn> = <ergebnisn> | #default = <standardergebnis> }}
switch
geht alle Werte durch, bis der Vergleichswert gefunden wird. Dann wird das entsprechende Ergebnis (hinter dem Gleichheitszeichen) zurückgegeben. Wenn kein Wert übereinstimmt, wird der Eintrag unter #default
verwendet, sofern es diesen gibt. (Falls das Standardergebnis kein Gleichheitszeichen enthält, kann #default=
auch weggelassen werden.)
„Rückfall“-Werte sind ebenfalls möglich:
{{#switch: <vergleichswert> | <wert1> | <wert2> | <wert3> = <ergebnis1,2,3> | ... | <wertn> = <ergebnisn> | #default = <standardergebnis> }}
Hier wird für <wert1>
, <wert2>
und <wert3>
derselbe Wert <ergebnis1,2,3>
zurückgegeben.
Funktion time
#time ist eine Zeit- und Datums-Formatierungs-Funktion. Sie liefert die Koordinierte Weltzeit (UTC).
Für die lokale Zeit kann die Funktion #timel angewandt werden.
Die Syntax ist
{{ #time: format }}
oder
{{ #time: format | time }}
Wenn „time“ nicht angegeben wird, wird die Zeit zum Zeitpunkt der Umwandlung in HTML benutzt. Durch das Servercaching kann es dabei zu Abweichungen bei der Artikelanzeige bis zu einer Woche kommen. Eine manuelle Aktualisierung kann durch einen Purge erfolgen.
Von MediaWiki unterstützte „format“-Parameter: DjlNwzWFmMntLoYyaAgGhHiscrU (Erklärung der Codes auf php.net).
Die wichtigsten Codes werden in der folgenden Tabelle erklärt. Alle numerischen Codes geben Zahlen entsprechend der lokalen Spracheinstellung zurück, durch die Nutzung des xn-Codes kann dieses Verhalten überschrieben werden.
Code | Beschreibung | Ausgabe |
---|---|---|
d | Tag, mit führender Null | 01 |
j | Tag, ohne führende Null | 1 |
z | Tag in Jahr | 0 |
D | Wochentag, abgekürzt | Mi |
l | Wochentag, ausgeschrieben | Mittwoch |
w | Wochentag numerisch, Sonntag=0 | 3 |
F | Monatsname, ausgeschrieben | Januar |
m | Monat, mit führender Null | 01 |
n | Monat, ohne führende Null | 1 |
M | Monatsname, abgekürzt | Januar |
Y | Jahr, 4-stellig | 2025 |
y | Jahr, 2-stellig. | 25 |
H | Stunde, mit führender Null | 22 |
i | Minute, mit führender Null | 16 |
s | Sekunde, mit führender Null | 55 |
Die folgenden Codes sind Erweiterungen zu PHP:
Code | Beschreibung | Ausgabe |
---|---|---|
xn | Formatiert den nächsten numerischen Code als Roh-ASCII. Beispiel, in Hindi: {{ #time:H, xnH}} ergibt ०६, 06. | |
xr | Formatiert den nächsten numerischen Code als römische Zahl. | {{ #time: xrY }} → MMXXV |
xg | Gibt die Genitivform des Monatsnamens aus; für Sprachen, die zwischen Genitiv und Nominativ unterscheiden. | Januars |
xx | Der Buchstabe „x“ | x |
xmj |
Tag nach islamischer Zeitrechnung |
1 Radschab |
xij |
Tag im iranischen Kalender |
12 Dey |
xjj |
Tag im jüdischen Kalender |
1 29 |
xkY | Jahr im thailändischen Sonnenkalender (Tag und Monat sind mit dem Gregorianischen Kalender identisch) | 2568 |
xoY | Jahr im chinesischen Minguo-Kalender (Tag und Monat sind mit dem Gregorianischen Kalender identisch) | 114 |
xtY | Jahr im japanischen Nengō-Kalender (Tag und Monat sind mit dem Gregorianischen Kalender identisch) | 平成37 |
Jedes unbekannte Zeichen wird unbearbeitet zur Ausgabe durchgereicht. Dazu gibt es zwei Konventionen:
- Zeichen in doppelten Anführungszeichen werden als solche ausgegeben (ohne Anführungszeichen). Anführungszeichen alleine werden als solche ausgegeben. Beispiele:
- {{ #time: "Der Monat ist" F}} → Der Monat ist Januar
- {{ #time:i's"}} → 16'55"
- Backslash-escaping wird unterstützt: \H ergibt das Zeichen H, \" ergibt das Zeichen ".
Das Format des „time“-Parameters ist identisch mit der PHP-Funktion strtotime(). Relative Angaben, wie zum Beispiel „+10 hours“, werden unterstützt, welche für eine Zeitzonen-Berechnung genutzt werden können.
Code | Beschreibung | Ausgabe |
---|---|---|
{{ #time:j"."n"."Y H":"i":"s|2 days 10 hours 40 minutes ago}} | Das angezeigte Datum wird um 2 Tage, 10 Stunden und 40 Minuten nach hinten verschoben | 30.12.2024 11:36:55 |
{{ #time:j"."n"."Y H":"i":"s|yesterday}} | Gestern | 31.12.2024 00:00:00 |
{{ #time:j"."n"."Y H":"i":"s|tomorrow}} | Morgen | 2.1.2025 00:00:00 |
{{#time:j"."n"."Y H":"i":"s|2 days}} | Übermorgen | 3.1.2025 22:16:55 |
{{#time:j"."n"."Y H":"i":"s|2 years 2 months 2 weeks 2 days}} | In 2 Jahren, 2 Monaten, 2 Wochen und 2 Tagen | 17.3.2027 22:16:55 |
{{#time:j"."n"."Y H":"i":"s|1 year 1 month 1 week 1 day}} | In einem Jahr, einem Monat, einer Woche und einem Tag | 9.2.2026 22:16:55 |
{{#time:xjj. xjF xjY}} | Aktuelles Datum nach dem jüdischen Kalender | 1. Tevet 5785 |
{{#time:xmj. xmF xmY}} | Aktuelles Datum nach dem islamischer Zeitrechnung | 1. Radschab 1446 |
{{#time:xij. xiF xiY}} | Aktuelles Datum nach dem iranischen Kalender | 12. Dey 1403 |
{{#time:j. F xkY}} | Aktuelles Datum nach dem Thailändischen Sonnenkalender | 1. Januar 2568 |
{{#time:j. F xoY}} | Aktuelles Datum nach dem chinesischen Minguo-Kalender | 1. Januar 114 |
{{#time:xtY/n/j}} | Aktuelles Datum nach dem japanischen Nengō-Kalender | 平成37/1/1 |
Siehe das GNU tar manual für weitere Informationen.
Funktion rel2abs
{{#rel2abs:}}
ermöglicht die relative Navigation in Unterseiten.
Ein relativer Seitenpfad kann ".", ".." sein oder mit "/", "./" "../" beginnen.
Relativer Seitenpfad | Basis | Beispiel | Ergebnis |
---|---|---|---|
. | {{#rel2abs: .}}
|
Hilfe:Vorlagenprogrammierung | |
.. | {{#rel2abs: ..}}
|
||
. | ns:a/b | {{#rel2abs: .|ns:a/b}}
|
ns:a/b |
.. | ns:a/b | {{#rel2abs: ..|ns:a/b}}
|
ns:a |
/x | ns:a/b | {{#rel2abs: /x|ns:a/b}}
|
ns:a/b/x |
./x | ns:a/b | {{#rel2abs: ./x|ns:a/b}}
|
ns:a/b/x |
../x | ns:a/b | {{#rel2abs: ../x|ns:a/b}}
|
ns:a/x |
../../x | ns:a/b | {{#rel2abs: ../../x|ns:a/b}}
|
x |
Funktion titleparts
{{#titleparts:}}
gibt die angegebene Anzahl an Teilen (ab einer angegebenen Stelle) eines Seitentitels zurück, die durch einen Schrägstrich ("/
") getrennt sind. Beispiele:
{{#titleparts:Hilfe:Verweis/a/b|0}}
ergibtHilfe:Verweis/a/b
(Der ganze Name){{#titleparts:Hilfe:Verweis/a/b|1}}
ergibtHilfe:Verweis
{{#titleparts:Hilfe:Verweis/a/b|2}}
ergibtHilfe:Verweis/a
{{#titleparts:Hilfe:Verweis/a/b|1|2}}
ergibta
{{#titleparts:Hilfe:Verweis/a/b|2|2}}
ergibta/b
Mit negativen Werten wird von rechts der Teil zurückgegeben:
{{#titleparts:Hilfe:Verweis/a/b|1|-1}}
ergibtb
Die Funktion ist nur für Seitennamen ausgelegt. Daher funktionieren die Funktion nur mit Zeichen, die auch im Seitennamen erlaubt sind. Im Fehlerfall wird der gesamte Parameter zurückgegeben.
Verwendung mit subst
Die ParserFunctions können auch mit subst verwendet werden, solange kein Leerzeichen zwischen subst:
und #
steht.
Hierbei ist aber zu beachten, dass sich die ParserFunctions sehr unterschiedlich verhalten. Daher ist ein Test vorher immer anzuraten. Für Tipps und Tricks gibt es eine englischsprachige Hilfeseite.
Überprüfung von Zeichenketten
Mit #expr: können zwar numerische Werte, jedoch keine Zeichenketten verwendet werden. Dies lässt sich aber über die folgenden Vorlagen bewerkstelligen. Sie sind nicht Teil der ParserFunctions, werden allerdings der Vollständigkeit halber hier mit aufgelistet, um einen umfassenden Überblick über die zur Vorlagen-Programmierung einsetzbaren Mittel zu geben.
Bitte verwende diese Vorlagen mit Bedacht, da sie nicht server-freundlich sind.
{{str len|Text}} ermittelt die Länge von Text (von 0 bis 128)
Nachfolgend bedeutet wahr, dass der jeweilige Parameter eine nicht-leere Zeichenkette enthält sowie nicht nur aus Whitespaces besteht.
Syntax | Beschreibung | Wahrheitstabelle |
---|---|---|
{{booland|A|B}} | Das Ergebnis ist wahr, wenn A und B wahr sind. | Vorlage:Wahrheitstabelle |
{{boolor|A|B}} | Das Ergebnis ist wahr, wenn A und/oder B wahr sind. Bitte verkette die zu überprüfenden Parameter einfach, zum Beispiel:
|
Vorlage:Wahrheitstabelle |
{{boolxor|A|B}} | Das Ergebnis ist wahr, wenn entweder A oder B wahr ist. | Vorlage:Wahrheitstabelle |
{{booleq|A|B}} | Das Ergebnis ist wahr, wenn A und B gleich sind. | Vorlage:Wahrheitstabelle |
{{boolnand|A|B}} | Das Ergebnis ist wahr, wenn A oder B falsch sind. | Vorlage:Wahrheitstabelle |
{{boolnor|A|B}} | Das Ergebnis ist wahr, wenn A und B falsch sind. Bitte verwende die bei boolor beschriebene Oder-Syntax mit vertauschten Dann- und Sonst-Zweigen. |
Vorlage:Wahrheitstabelle |
{{boolandnot|A|B}} | Das Ergebnis ist wahr, wenn A wahr und B falsch ist. | Vorlage:Wahrheitstabelle |
{{boolornot|A|B}} | Das Ergebnis ist wahr, wenn A wahr oder B falsch ist. | Vorlage:Wahrheitstabelle |
{{boolnot|A}} | Das Ergebnis ist wahr, wenn A falsch ist. Bitte nutze ein if mit leerem dann-Zweig, zum Beispiel:
|
Vorlage:Wahrheitstabelle |
Des Weiteren gibt es noch Vorlage:Booland3 und Vorlage:Booland4, welche der Und-Verknüpfung von drei bzw. vier Zeichenketten dienen.
Besonderheiten
Tabellen
siehe Problem: Senkrechter Strich in Parameterwerten
Programmierhilfen
Um den Quelltext nicht zu sehr aufzublähen, gibt es Vorlagen, mit denen Berechnungen eingebunden werden können:
- Vorlage:Ziffer extrahiert eine Ziffer aus einer Ganzzahl
- Vorlage:Quersumme berechnet eine Quersumme
- Vorlage:Min und Vorlage:Max bestimmen das Minimum bzw. Maximum von zwei bis drei Zahlen
- Vorlage:IstZahl prüft, ob ein Parameter eine Zahl ist oder nicht
- Vorlage:Maß Formatierung einheitenbehafteter Parameter
- Vorlage:DezimalkommaZuPunkt vereinheitlicht das Zahlenformat für
#expr:
, wenn es gemischt vorkommt. Vorlage:Formnum wandelt das Zahlenformat wieder zurück in die deutsche Schreibweise mit , als Dezimaltrenner. Die Verwendung dieser beiden Vorlagen ist nur sinnvoll, wenn mit Parameterwerten bestehender Vorlagen, die in unterschiedlichem Format vorliegen, gearbeitet werden soll, ohne sie durch einen Boteinsatz in ein einheitliches Format bringen zu müssen. Es ist nicht sinnvoll, neue Infoboxen und dergleichen mit diesen Vorlagen zu versehen. Bitte stattdessen die Parameterwerte einfach gleich von Anfang an im richtigen Format erfassen und die Parserfunktion{{formatnum:…}}
verwenden.
Funktion tag
Sämtliche tags der MediaWiki können mit Hilfe der Funktion #tag angesprochen und ausgewertet werden. Dies ist insbesondere bei der Verwendung von dynamischen Imagemaps oder Quellenangaben hilfreich.
So kann innerhalb von Vorlagen anstelle von <imagemap>…</imagemap>
auch {{#tag:imagemap|…}}
geschrieben werden, wobei senkrechte Striche durch {{!}}
zu ersetzen sind. Damit wird die Auswertung von Parametern innerhalb der Imagemap ermöglicht.
Links und CSS-Farben maskieren
Besonders interessant ist die Funktion auch zusammen mit <nowiki>
. So können in Vorlagen potienzielle Links maskiert werden, damit sie als reiner Text ausgegeben werden: {{#tag:nowiki|{{{Link}}}}}
(zum Beispiel wenn eine URL selbst auf eine andere Seite zeigen soll). Farbangaben im Format #rrggbb werden normalerweise als Aufzählungen interpretiert, wenn sie als Parameter übergeben werden (Bug 12974). Dies lässt sich auf gleiche Weise umgehen: {{#tag:nowiki|{{{Farbe}}}}}
.
Testen
Vorlagen mit Parserfunktionen können auf der Spezialseite Vorlagen expandieren getestet werden.
Dabei wird der Aufruf der Vorlage (bspw. Vorlage:Infobox Tennisspieler) mit ihren Parametern in das „Eingabefeld“ kopiert:
{{Infobox Tennisspieler | Nationalität = deutsch | Geburtstag = 01.01.2000 | ErsteProfisaison = 2000 | Spielhand = links oder rechts }}
Über das Feld „Kontexttitel“ kann optional ein Seitenname übergeben werden, der die seitenabhängige Variable {{PAGENAME}}
füllt.
Beispielhafter Seitenname
Im o. g. Beispiel führt dies dazu, dass in der Vorschau oberhalb der Infobox nicht „ExpandTemplates“, sondern „Beispielhafter Seitenname“ angezeigt wird.
Beim Erstellen oder Ändern von Vorlagen kann der Quelltext kurzzeitig auf die Vorlage:Spielwiese kopiert und dort geändert werden, bis er richtig funktioniert. Danach wird der getestete Quelltext in das „Bearbeiten“-Fenster der eigentlichen Vorlage kopiert, gespeichert und die Spielwiese wieder gesäubert.