Hurin Thalion: Änderungen von 114.148.68.116 (Diskussion) rückgängig gemacht und letzte Version von Swyft wiederhergestellt

2012-08-10T01:41:11Z

Änderungen von 114.148.68.116 (Diskussion) rückgängig gemacht und letzte Version von Swyft wiederhergestellt

Änderungen zeigen

84.146.171.158: rHskieWf

2012-08-09T23:16:33Z

rHskieWf

Änderungen zeigen

Swyft: brotkrumen

2011-12-08T17:39:21Z

brotkrumen

← Nächstältere Version		Version vom 8. Dezember 2011, 19:39 Uhr
Zeile 1:		Zeile 1:
	~~< [[Ardapedia:Hilfe~~\|Hilfe~~]] < [[Ardapedia:Bausteine~~\|Bausteine~~]] < '''Vorlagenprogrammierung'''~~		{{Brotkrumen\|Hilfe\|Bausteine}}


	{{Navigationsleiste Ardapedia Bausteine}}		{{Navigationsleiste Ardapedia Bausteine}}
Zeile 139:		Zeile 138:
	{{Code\|switch}} vergleicht einen Wert mit mehreren anderen. Die Grundsyntax ist:		{{Code\|switch}} vergleicht einen Wert mit mehreren anderen. Die Grundsyntax ist:

	<~~div style="background-color:#336633;"><tt~~>{{ #switch: <vergleichswert><br/>		<code>{{ #switch: <vergleichswert><br/>
	\| <wert<sub>1</sub>> = <ergebnis<sub>1</sub>><br/>		\| <wert<sub>1</sub>> = <ergebnis<sub>1</sub>><br/>
	\| <wert<sub>2</sub>> = <ergebnis<sub>2</sub>><br/>		\| <wert<sub>2</sub>> = <ergebnis<sub>2</sub>><br/>
	\| ...<br/>		\| ...<br/>
	\| <wert<sub>n</sub>> = <ergebnis<sub>n</sub>><br/>		\| <wert<sub>n</sub>> = <ergebnis<sub>n</sub>><br/>
	\| #default = <standardergebnis> }}</~~tt></div~~>		\| #default = <standardergebnis> }}</code>

	{{Code\|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 {{Code\|#default}} verwendet, sofern es diesen gibt. (Falls das Standardergebnis kein Gleichheitszeichen enthält, kann {{Code\|#default}} auch weggelassen werden.)		{{Code\|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 {{Code\|#default}} verwendet, sofern es diesen gibt. (Falls das Standardergebnis kein Gleichheitszeichen enthält, kann {{Code\|#default}} auch weggelassen werden.)

	„Durchfall“-Werte sind ebenfalls möglich: <~~div style="background-color:#336633;"><tt~~>{{ #switch: <vergleichswert><br/>		„Durchfall“-Werte sind ebenfalls möglich:

			<code>{{ #switch: <vergleichswert><br/>
	\| <wert<sub>1</sub>><br/>		\| <wert<sub>1</sub>><br/>
	\| <wert<sub>2</sub>><br/>		\| <wert<sub>2</sub>><br/>
Zeile 154:		Zeile 155:
	\| ...<br/>		\| ...<br/>
	\| <wert<sub>n</sub>> = <ergebnis<sub>n</sub>><br/>		\| <wert<sub>n</sub>> = <ergebnis<sub>n</sub>><br/>
	\| #default = <standardergebnis> }}</~~tt></div~~>		\| #default = <standardergebnis> }}</code>

	Hier wird für {{Code\|<wert<sub>1</sub>>}}, {{Code\|<wert<sub>2</sub>>}} und {{Code\|<wert<sub>3</sub>>}} derselbe Wert {{Code\|<ergebnis<sub>1,2,3</sub>>}} zurückgegeben.		Hier wird für {{Code\|<wert<sub>1</sub>>}}, {{Code\|<wert<sub>2</sub>>}} und {{Code\|<wert<sub>3</sub>>}} derselbe Wert {{Code\|<ergebnis<sub>1,2,3</sub>>}} zurückgegeben.

Swyft: überarbeitet

2007-08-12T18:20:20Z

überarbeitet

Änderungen zeigen

Swyft: neu aus wikipedia

2007-06-22T12:36:39Z

neu aus wikipedia

Neue Seite

{{Navigationsleiste Ardapedia Bausteine}}

< [[Ardapedia:Hilfe|Hilfe]] < [[Ardapedia:Bausteine|Bausteine]] < '''Vorlagenprogrammierung'''

Die Erweiterung „ParserFunctions“ für die von der Ardapedia verwendete MediaWiki-Software erlaubt bestimmte Konstrukte einer Programmiersprache, die ausschließlich in [[Ardapedia:Vorlagen|Vorlagen]] verwendet werden sollten.

Der Einsatz dieser Funktionen sollte stets wohl überlegt erfolgen. Nicht jede Spielerei, die möglich ist, ist auch sinnvoll. Entsprechende Vorlagen sind besonders sorgfältig zu dokumentieren.

== Beschreibung der Funktionen ==

=== if ===

Die <tt>if</tt>-Funktion ist ein Wenn-Dann-Sonst-Konstrukt. Die Syntax ist

<tt>{{ #if: <bedingung> | <dann-text> | <sonst-text> }}</tt>

Enthält die <tt><bedingung></tt> Text, gilt sie als erfüllt und es wird <tt><dann-text></tt> zurückgegeben. Ist <tt><bedingung></tt> hingegen leer oder besteht ausschließlich aus Leerzeichen (whitespace), gilt sie als nicht erfüllt und es wird <tt><sonst-text></tt> zurückgegeben.

<tt><sonst-text></tt> kann auch weggelassen werden, dann wird in diesem Fall nichts zurückgegeben.

'''Beachte:''' <tt>if</tt> unterstützt keine Gleichungen oder Ähnliches. Siehe dafür <tt>ifeq</tt> und <tt>ifexpr</tt>.

=== ifeq ===

<tt>ifeq</tt> vergleicht zwei Zeichenketten und gibt je nach Ergebnis verschiedene Texte zurück.

<tt>{{ #ifeq: <text 1> | <text 2> | <text wenn gleich> | <text wenn ungleich> }}</tt>

=== ifexist ===

<tt>ifexist</tt> prüft, ob unter einem angegebenen Stichwort ein Artikel existiert, und gibt je nachdem verschiedene Texte zurück.

<tt>{{ #ifexist: <Artikel> | <Text wenn Artikel existiert> | <Text wenn Artikel nicht existiert> }}</tt>

=== expr ===

<tt>expr</tt> berechnet mathematische Ausdrücke.

<tt>{{ #expr: <ausdruck> }}</tt>

{| {{Tabellendesign}}
|+ Mögliche Operationen
|-
! {{Highlight}} | Operator
! {{Highlight}} | Operation
! {{Highlight}} | Beispiel
|-
| '''*'''
| Multiplikation
| <tt>{{ #expr: 30 * 7 }}</tt> = {{#expr: 30 * 7}}
|-
| '''/''' oder '''div'''
| Division
| <tt>{{ #expr: 30 / 7 }}</tt> = {{#expr: 30 / 7}}
|-
| '''+'''
| Addition
| <tt>{{ #expr: 30 + 7 }}</tt> = {{#expr: 30 + 7}}
|-
| '''-'''
| Subtraktion
| <tt>{{ #expr: 30 - 7}}</tt> = {{#expr: 30 - 7}}
|-
| '''mod'''
| Modulo, der Rest einer Division
| <tt>{{ #expr: 30 mod 7 }}</tt> = {{#expr: 30 mod 7}}
|-
| '''round'''
| rundet die Zahl auf der linken Seite auf die Anzahl Nachkommastellen,
die von der Zahl auf der rechten Seite angegeben wird
| <tt>{{ #expr: 30 / 7 round 7 }}</tt> = {{#expr: 30 / 7 round 7}}
|-
| '''='''
| Gleichheit
| <tt>{{ #expr: 30 = 7 }}</tt> = {{#expr: 30 = 7}}
|-
| '''<>''' oder '''!='''
| Ungleichheit
| <tt>{{ #expr: 30 <> 7 }}</tt> = {{#expr: 30 <> 7}}
|-
| '''<'''
| kleiner als
| <tt>{{ #expr: 30 < 7 }}</tt> = {{#expr: 30 < 7}}
|-
| '''>'''
| größer als
| <tt>{{ #expr: 30 > 7 }}</tt> = {{#expr: 30 > 7}}
|-
| '''<='''
| kleiner oder gleich
| <tt>{{ #expr: 30 <= 7 }}</tt> = {{#expr: 30 <= 7}}
|-
| '''>='''
| größer oder gleich
| <tt>{{ #expr: 30 >= 7 }}</tt> = {{#expr: 30 >= 7}}
|-
| '''and'''
| logisches UND
| <tt>{{ #expr: 30 and 7 }}</tt> = {{#expr: 30 and 7}}
|-
| '''or'''
| logisches ODER
| <tt>{{ #expr: 30 or 7 }}</tt> = {{#expr: 30 or 7}}
|-
| '''not'''
| logisches NICHT
| <tt>{{ #expr: not 7 }}</tt> = {{#expr: not 7}}
|-
| '''( )'''
| Gruppierung/Klammerung
| <tt>{{ #expr: (30 + 7) * 7 }}</tt> = {{#expr: (30 + 7) * 7 }}
|}

Die boolschen Operatoren behandeln 0 (Null) als falsch und 1 als wahr. Zahlen werden
mit dem Punkt als Dezimaltrenner angegeben.

'''Beispiel:'''

<tt>{{ #expr: (100 - 32) / 9 * 5 round 0 }}</tt>

ergibt: {{ #expr: (100 - 32) / 9 * 5 round 0 }}

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: <tt>{{ #expr: 13000 / 3.1 round 2}}</tt> ergibt {{ #expr: 13000 / 3.1 round 2 }}) müssen solche Zahlen zusätzlich in das im deutschen Sprachraum übliche Format umgewandelt werden (Beispiel: <tt>{{[[Ardapedia:Variablen|formatnum:]] {{ #expr: 13000 / 3.1 round 2 }} }}</tt> ergibt {{ formatnum: {{ #expr: 13000 / 3.1 round 2 }} }}).

=== ifexpr ===

<tt>ifexpr</tt> wertet einen mathematischen Ausdruck aus. <tt>{{ #ifexpr: <ausdruck> | <dann-text> | <sonst-text> }}</tt>

Ist das Ergebnis von <tt><ausdruck></tt> 0 (Null), wird <tt><sonst-text></tt> zurückgegeben. Sonst wird <tt><dann-text></tt> zurückgegeben.

<tt><sonst-text></tt> kann auch weggelassen werden, dann wird in diesem Fall nichts zurückgegeben.

Die Syntax für Ausdrücke wird in der Beschreibung von <tt>expr</tt> erklärt.

=== switch ===

<tt>switch</tt> vergleicht einen Wert mit mehreren anderen. Die Grundsyntax ist:

<div style="background-color:#336633;"><tt>{{ #switch: <vergleichswert> 
| <wert1> = <ergebnis1> 
| <wert2> = <ergebnis2> 
| ... 
| <wertn> = <ergebnisn> 
| #default = <standardergebnis> }}</tt></div>

<tt>switch</tt> 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 <tt>#default</tt> verwendet, sofern es diesen gibt. (Falls das Standardergebnis kein Gleichheitszeichen enthält, kann <tt>#default</tt> auch weggelassen werden.)

„Durchfall“-Werte sind ebenfalls möglich: <div style="background-color:#336633;"><tt>{{ #switch: <vergleichswert> 
| <wert1> 
| <wert2> 
| <wert3> = <ergebnis1,2,3> 
| ... 
| <wertn> = <ergebnisn> 
| #default = <standardergebnis> }}</tt></div>

Hier wird für <tt><wert1></tt>, <tt><wert2></tt> und <tt><wert3></tt> derselbe Wert <tt><ergebnis1,2,3></tt> zurückgegeben.

=== time ===

<tt>#time</tt> ist eine Zeit- und Datums-Formatierungsfunktion. Die Syntax ist <tt>{{ #time: <format> }}</tt>
oder <tt>{{ #time: <format> | <zeit> }}</tt>

Wenn <zeit> nicht angegeben wird, wird die Zeit zum Zeitpunkt der Umwandung in HTML benutzt. Durch das Servercaching kann es dabei zu Abweichungen bei der Artikelanzeige kommen. Eine manuelle Aktualisierung kann durch einen „null edit“ (Seite bearbeiten und Speichern ohne Änderung) erfolgen.

Der <format>-Parameter ist ähnlich den der [http://php.net/date PHP-Datumsparameter].

Die folgenden Codes haben dieselbe Bedeutung wie in PHP. Alle numerischen Codes geben Zahlen entsprechend der lokalen Spracheinstellung zurück, durch die Nutzung des xn-Codes
kann dieses Verhalten überschrieben werden.

{| {{Tabellendesign}}
! {{Highlight}} | Code
! {{Highlight}} | Beschreibung
! {{Highlight}} | Ausgabe
|-
| d
| Tag, mit führender Null
| {{ #time: d }}
|-
| D
| Abkürzung des Wochentages, nur in seltenen Fällen internationalisiert.
| {{ #time: D }}
|-
| j
| Tag, ohne führende Null
| {{ #time: j }}
|-
| l
| Ausgeschriebener Name des Wochentages, nur in seltenen Fällen internationalisiert.
| {{ #time: l }}
|-
| F
| Ausgeschriebener Name des Monatnamens, in der Regel internationalisiert
| {{ #time: F }}
|-
| m
| Monat, mit führender Null.
| {{ #time: m }}
|-
| M
| Abgekürzter Name des Monatnamens, in der Regel internationalisiert
| {{ #time: M }}
|-
| n
| Monat, ohne führende Null.
| {{ #time: n }}
|-
| Y
| Jahr, 4-stellig
| {{ #time: Y }}
|-
| y
| Jahr, 2-stellig.
| {{ #time: y }}
|-
| H
| Stunde, mit führender Null
| {{ #time: H }}
|-
| i
| Minute, mit führender Null
| {{ #time: i }}
|-
| s
| Sekunde, mit führender Null
| {{ #time: s }}
|}

Die folgenden Codes sind Erweiterungen zu PHP:

{| {{Tabellendesign}}
! {{Highlight}} | Code
! {{Highlight}} | Beschreibung
|-
| xn
| Formatiere den nächsten numerischen Code als Roh-ASCII. Beispiel, in Hindi: {{ #time:H, xnH}} ergibt ??, 06.
|-
| xr
| Formatiere den nächsten numerischen Code als römische Zahl
|-
| xg
| Gebe die Genitivform des Monatsnamens aus, für Sprachen, die eine Unterscheidung zwischen Genitiv und Nominativ machen.
|-
| xx
| Der Buchstabe „x“
|}

Jedes unbekannte Zeichen wird unbearbeitet zur Ausgabe durchgereicht. Dazu gibt es zwei Konventionen zur unbearbeiteten Zeichenausgabe:
* Zeichen in doppelten Anführungszeichen werden als solche ausgegeben (ohne Anführungszeichen). Anführungszeichen alleine werden als solche ausgegeben. Beispiele:
** {{ #time: "The month is" F}} ? The month is January
** {{ #time:i's"}} ? 20'11"
* Backslash-escaping wird unterstützt: \H ergibt das Zeichen H, \" ergibt das Zeichen ".

Das Format des <zeit>-Parameters ist identisch mit der PHP-Funktion strtotime(). Relative Angaben, wie z.B. „+10 hours“ werden unterstützt, welche für eine Zeitzonen-Berechnung genutzt werden kann.

{| {{Tabellendesign}}
! {{Highlight}} | Code
! {{Highlight}} | Beschreibung
! {{Highlight}} | Ausgabe
|-
| <nowiki>{{ #time:j"."n"."Y H":"i":"s|2 days 10 hours 40 minutes ago}}</nowiki>
|Das angezeigte Datum wird um 2 Tage, 10 Stunden und 40 Minuten nach hinten verschoben
|{{#time:j":"n":"Y H":"i":"s|2 days 10 hours 40 minutes ago}}
|-
| <nowiki>{{ #time:j"."n"."Y H":"i":"s|yesterday}}</nowiki>
|Gestern
| {{ #time:j"."n"."Y H":"i":"s|yesterday}}
|-
| <nowiki>{{ #time:j"."n"."Y H":"i":"s|tomorrow}}</nowiki>
|Morgen
| {{ #time:j"."n"."Y H":"i":"s|tomorrow}}
|-
|<nowiki>{{#time:j"."n"."Y H":"i":"s|2 days}}</nowiki>
| Übermorgen
| {{#time:j"."n"."Y H":"i":"s|2 days}}
|-
|<nowiki>{{#time:j"."n"."Y H":"i":"s|2 years 2 months 2 weeks 2 days}}</nowiki>
|In 2 Jahren, 2 Monaten, 2 Wochen und 2 Tagen
| {{#time:j"."n"."Y H":"i":"s|2 years 2 months 2 weeks 2 days}}
|-
|<nowiki>{{#time:j"."n"."Y H":"i":"s|1 year 1 month 1 week 1 day}}</nowiki>
|In einem Jahr, einem Monat, einer Woche und einem Tag
| {{#time:j"."n"."Y H":"i":"s|1 year 1 month 1 week 1 day}}
|}

Siehe das [http://www.gnu.org/software/tar/manual/html_node/tar_109.html „GNU tar manual“] für weitere Informationen.

=== Verwendung mit subst ===

Die ParserFunctions können auch mit subst verwendet werden, solange kein Leerzeichen zwischen <tt>subst:</tt> und <tt>#</tt> steht.

== Probleme ==

=== Tabellen ===

Die Wikisyntax für Tabellen kann nicht innerhalb von Bedingungen verwendet werden, daher muss anstatt des Pipe-Zeichens („|“) die [[Vorlage:!]] verwendet werden.

== Weblinks ==

* [http://meta.wikimedia.org/wiki/ParserFunctions ParserFunctions auf meta.wikimedia.org]

{{Wikipedia|Hilfe:Vorlagenprogrammierung}}
[[Kategorie:Hilfe|Vorlagenprogrammierung]]

Ardapedia:Vorlagenprogrammierung - Versionsgeschichte

Hurin Thalion: Änderungen von 114.148.68.116 (Diskussion) rückgängig gemacht und letzte Version von Swyft wiederhergestellt

84.146.171.158: rHskieWf

Swyft: brotkrumen

Swyft: überarbeitet

Swyft: neu aus wikipedia