Hilfe:Parserfunktionen - Versionsgeschichte

Cowboy am 13. August 2026 um 20:07 Uhr

2026-08-13T20:07:39Z

Cowboy: Die Seite wurde neu angelegt: „{{Hilfe}} Diese Hilfeseite beschreibt die vom '''{{WP|Parser}}''' der {{WP|MediaWiki}}-Software sofort ausgewerteten '''Funktionen'''. Im /Index/ ist eine Liste aller in {{SITENAME}} und darüber hinaus definierten Parserfunktionen zusammengestellt. ===== Allgemeines ===== Parserfunktionen sind Konstrukte im {{WP|Wikitext}}, die…“

2026-08-13T20:02:55Z

Die Seite wurde neu angelegt: „<noinclude>{{Hilfe}} Diese Hilfeseite beschreibt die vom '''{{WP|Parser}}''' der {{WP|MediaWiki}}-Software sofort ausgewerteten '''Funktionen'''. Im /Index/ ist eine Liste aller in {{SITENAME}} und darüber hinaus definierten Parserfunktionen zusammengestellt. </noinclude> <includeonly>===</includeonly><noinclude>==</noinclude> Allgemeines <includeonly>===</includeonly><noinclude>==</noinclude> Parserfunktionen sind Konstrukte im {{WP|Wikitext}}, die…“

Neue Seite

<noinclude>{{Hilfe}}
Diese Hilfeseite beschreibt die vom '''{{WP|Parser}}''' der {{WP|MediaWiki}}-Software sofort ausgewerteten '''Funktionen'''.

Im [[/Index/]] ist eine Liste aller in {{SITENAME}} und darüber hinaus definierten Parserfunktionen zusammengestellt.
</noinclude>
<includeonly>===</includeonly><noinclude>==</noinclude> Allgemeines <includeonly>===</includeonly><noinclude>==</noinclude>
Parserfunktionen sind Konstrukte im {{WP|Wikitext}}, die in einen teils recht statischen, teils sehr dynamischen anderen Text umgewandelt werden. Sie sind in doppelte geschweifte Klammern <code><nowiki>{{}}</nowiki></code> eingeschlossen.

In enzyklopädischen Artikeln ist eine direkte Verwendung in der Regel unerwünscht, abgesehen von einigen verbreiteten Vertretern wie [[Hilfe:SEITENTITEL|SEITENTITEL]] oder dem Sortierschlüssel von Kategorien. Ein Grund dafür ist, dass die zugehörige Dokumentation (anders als bei [[Hilfe:Vorlagen|Vorlagen]]) nicht unmittelbar erreichbar ist.

In erster Linie werden Parserfunktionen zur [[Hilfe:Vorlagen/Programmierung|Programmierung von Vorlagen]] verwendet; auch auf Funktionsseiten usw. außerhalb des enzyklopädischen Bereichs.

Jedes Wiki kann gewissermaßen seine eigenen „Funktionen“ dieser Art herstellen; das sind gerade die [[Hilfe:Vorlagen|Vorlagen]].

<includeonly>===</includeonly><noinclude>==</noinclude> {{Anker|Bezeichner}} Syntax und Bezeichner <includeonly>===</includeonly><noinclude>==</noinclude>
Die Einbindung einer Parserfunktion ohne Parameter in den {{WP|Wikitext}} ist syntaktisch zunächst nicht von einer [[Hilfe:Vorlagen|Vorlage]] zu unterscheiden; siehe [[Hilfe:Seiten einbinden|Seiten einbinden]].
* <code>{{</code>''irgendwas''<code>}}</code> kann beides sein.
* Um dies zu vermeiden und eindeutig zu machen, haben pfiffige Entwickler dem Bezeichner der jeweiligen Parserfunktion ein <code>#</code> vorangestellt.<ref>Siehe {{Phab|Task=204370}} ''Behavior switch/magic word uniformity''</ref>
** Das ist unmöglich für eine Vorlage.
** Allerdings sind bei weitem nicht alle Parserfunktionen mit derartigen Bezeichnern ausgestattet worden.
* Falls der unerwünschte Fall auftreten soll, dass eine Vorlage den gleichen Bezeichner wie eine Parserfunktion trägt, wäre <span style="white-space:nowrap"><code>{{Vorlage:</code>''irgendwas''<code>}}</code></span> eindeutig eine Vorlage.
** Bei gleichen Namen hat ansonsten die Parserfunktion immer Vorrang; es wird bei ihrem Antreffen nicht mehr nach einbindbaren Seiten gesucht.
** <code>[[Hilfe:Parserfunktionen/Programmierung#msg|msg:]]</code> wäre eine weitere Möglichkeit, um Konflikte aufzulösen.
* Beim Bezeichner einer Parserfunktion hat die Groß- und Kleinschreibung keine Bedeutung.
** Das ist anders als bei Vorlagen, wo dies nur für einen ersten Buchstaben gilt.
** Für quasistatische, eher konstante Werte werden meist Großbuchstaben benutzt; steht ein funktionaler Aspekt mit Parametern im Vordergrund dann eher Kleinbuchstaben.
* Beim Bezeichner einer Parserfunktion ist ein Unterstreichungsstrich  <code>_</code> signifikant, also nicht gleichbedeutend mit einem Leerzeichen usw.
** Das ist anders als bei Vorlagen, auf deren Bezeichner alle [[Hilfe:Seitenname|Regeln zur Normalisierung]] angewendet werden können.
* Bei einer Parserfunktion mit Parametern wird der erste Parameterwert durch einen Doppelpunkt <code>:</code> abgetrennt.
** Daran lässt sich ggf. der Unterschied zu einer Vorlage erkennen, für die ein solcher Doppelpunkt ungewöhnlich wäre, obwohl syntaktisch möglich.<ref>Falls wie bei [[Vorlage:Info ISO-3166-2:CH]] tatsächlich Teil des Namens.</ref>
** Bei weiteren Parametern ist dies ein Pipe-Symbol <code>|</code> genau wie bei Vorlagen.
** Vor einem Doppelpunkt darf kein Leerzeichen stehen.
** Wenn ein Pflichtparameter erwartet wird, würde die Funktion ohne Doppelpunkt nicht als solche erkannt werden.
** Ein leerer Parameterwert ist unzulässig; der Doppelpunkt darf nicht das letzte nicht-leere Zeichen sein.
* {{Anker|L10N}} Zu einigen Bezeichnern gibt es deutschsprachige [[Lokalisierung (Softwareentwicklung)|Lokalisierungen]], die eher dort verwendet werden, wo Vorlagenprogrammierung durch Autoren von Artikeln selbst erfolgt. In fortgeschritteneren Bereichen sind auch für den globalen Austausch die generischen, englischsprachigen Bezeichner üblich. Das erleichtert dann auch die Suche in Quelltexten.

<includeonly>===</includeonly><noinclude>==</noinclude> Parameterwerte <includeonly>===</includeonly><noinclude>==</noinclude>
Für Parameter-Bezeichner, deren Syntax und ihre Werte gelten die analogen [[Hilfe:Vorlagen#Parameter|Regeln]] wie bei Vorlagen.
* Der erste Parameter wird jedoch mittels eines Doppelpunkts abgetrennt, alle weiteren dann mittels <code>|</code> (Pipe-Symbol).
* Parserfunktionen ganz ohne Parameter oder ohne aktuelle Angabe eines Parameters oder aber mit sich selten änderndem Resultat werden häufig nicht ganz korrekt als „Variablen“ bezeichnet, weil in den frühen Jahren das Konzept nicht wirklich durchschaut wurde.
* Hinsichtlich Trimmung, also führende oder schließende einfache Leerzeichen oder Zeilenumbrüche um Parameterwerte, werden diese von den allermeisten Parserfunktionen ignoriert.
** Eine wesentliche Ausnahme ist <code>[[Hilfe:Lua#invoke|#invoke]]</code>, auf die analoge Regeln wie bei Vorlagen angewendet werden.
* Pipes innerhalb von Verlinkungen, Medieneinbindungen oder Vorlageneinbindungen werden vor Auswertung der Parameterliste von den umgebenden Syntaxelementen konsumiert.
* HTML-Kommentare werden vor der Weitergabe eliminiert.
* Andere Seiteneinbindungen (Vorlagen) und Parserfunktionen werden vor der Weitergabe ausgewertet.
* Ein fehlender Pflichtparameters kann zur Interpretation des Bezeichners als Vorlage führen, falls dieser Bezeichner nicht mit <code>#</code> beginnt.
* Bei Funktionen, die keinen Parameter erwarten, darf auch keiner angegeben werden.

<includeonly>===</includeonly><noinclude>==</noinclude> Substitution <includeonly>===</includeonly><noinclude>==</noinclude>
Eine Substitution von Parserfunktionen ist analog [[Hilfe:Substitution|derer von Vorlagen]] und anderer eingebundener Seiten möglich.

Allerdings trifft das ggf. nur für solche Ergebnisse zu, die nicht von externen Gegebenheiten abhängen und keine Außenwirkung haben sollen.
* Ein Berechnungsergebnis konstanter Werte mit <code>[[Hilfe:Parserfunktionen/Zahlen#expr|#expr]]</code> ist das Berechnungsergebnis.
* Eine [[Hilfe:Parserfunktionen/Analysen|Statistik]] friert ihren Momentanzustand ein.
* Momentane [[Hilfe:Parserfunktionen/Datum und Zeit|Zeitpunkte]] und [[Hilfe:Parserfunktionen/Seite und URL|Seitenversionsdaten]] lassen sich einfrieren.
* [[Hilfe:Parserfunktionen/Kontrollstrukturen|Kontrollstrukturen]] dürfen ihrerseits nur von statischen Informationen abhängen; das kann aber auch jeder aktuelle Wert von Vorlagenparametern sein.
* [[Hilfe:SEITENTITEL|SEITENTITEL]] und [[Hilfe:Kategorien#Sortierung der Seiten in einer Kategorie|Sortierschlüssel]] sind nicht substituierbar; das Ergebnis ist „nichts“.

<includeonly>===</includeonly><noinclude>==</noinclude> Ergebnis <includeonly>===</includeonly><noinclude>==</noinclude>
{| class="wikitable float-right"
|- class="hintergrundfarbe8"
! Zeichen !! Entity
|-
|style="text-align:center"| <code>;</code> || <code>&#59;</code>
|-
|style="text-align:center"| <code>:</code> || <code>&#58;</code>
|-
|style="text-align:center"| <code>*</code> || <code>&#42;</code>
|-
|style="text-align:center"| <code>#</code> || <code>&#35;</code>
|-
|style="text-align:center"| Leerzeichen || <code>&#32;</code>
|-
|style="text-align:center"| Zeilenumbruch || <code>&#10;</code>
|}
* <span style="white-space:nowrap">Das Ergebnis einer Parserfunktion ist in aller Regel „getrimmt“,</span> also ohne führende oder schließende einfache Leerzeichen oder Zeilenumbrüche.
* Dem Ergebnis einer Parserfunktion wird aber genauso wie bei Vorlagen ein Zeilenumbruch vorangestellt, falls dieses netto mit <code>;</code> <code>:</code> <code>*</code> <code>#</code> <code>{|</code> beginnt.
** Das zielte darauf ab, damit [[Hilfe:Listen|Aufzählungen und Listen]] und [[Hilfe:Tabellen/Wikisyntax|Tabellen]] zu kennzeichnen. Andernfalls wäre dies wegen der Trimmung nicht möglich.
** Soll ein sichtbares derartiges Zeichen erscheinen, muss der Beginn des Ergebnisses zuvor in ein entsprechendes Entitiy gewandelt werden (siehe Tabelle rechts).
<noinclude>
== Einzelbeschreibungen ==

[[/Index/]] – Liste aller Einzelfunktionen

Thematisch gruppiert auf den Unterseiten:
* [[/Analysen/]] – Statistiken zum Wiki und zu einzelnen Kategorien.
* [[/Datum und Zeit/]]
* [[/Kontrollstrukturen/]] – ''Wenn – dann''
* [[/Multilingual/]] – Umgang mit menschlichen Sprachen
* [[/Programmierung/]] – Einbinden von Seiteninhalten und Elementen
* [[/Seite und URL/]]
* [[/Text/]] – Umgang mit Zeichenketten
* [[/Wiki/]] – Konfiguration des Wiki-Projekts
* [[/Zahlen/]] – Rechnen und Formatieren
* [[/Verschiedenes/]] – spezielle Einzelanwendungen
[[/*|Alles auf einer Seite]].
</noinclude>
<includeonly>===</includeonly><noinclude>==</noinclude> Geschichte und Herkunft <includeonly>===</includeonly><noinclude>==</noinclude>
Bereits in den allerersten Jahren wurden Parserfunktionen definiert, die Informationen über das Wiki oder die aktuelle Seite zugänglich machten.
* Das wurde dann ausgebaut mit Parametern.
* Mitte April 2006 wurden die beiden Funktionen <code>#if:</code> und <code>#switch:</code> eingeführt. Erst dadurch wurde eine Programmierung im eigentlichen Sinn möglich, weil erst damit eine Auswertung von Parameterwerten oder anderer Parserfunktionen eine Steuerung des Verhaltens bewirken konnte.
* Die meisten Parserfunktionen gehören zum anerkannten „Kern“ und sind damit auf allen Wikis der [[Wikimedia Foundation|WMF]] und auch außerhalb verfügbar.
** Einzelne Parserfunktionen werden durch bestimmte „Extensionen“ definiert.
** Manche Extensionen sind auf allen Wikis der WMF aktiviert; einige nur auf bestimmten, etwa zentralen mehrsprachigen usw.
** Auf privaten Wikis müssen entsprechende Extensionen üblicherweise gesondert installiert werden.
** Für ein Wiki ist es in der Regel unerheblich, ob eine Parserfunktion zum momentanen Kern oder zu einer Extension gehört.
* Eine Liste aller durch Erweiterungen (zusätzlich zum MediaWiki-Kern) eingebrachter Parserfunktionen ist auf [[Spezial:Version#mw-version-parser-function-hooks|Spezial:Version]] unter „Parsererweiterungen (Funktionen)“ aufgelistet (nur generische Namen).

<includeonly>====</includeonly><noinclude>===</noinclude> Schalterfunktionen <includeonly>====</includeonly><noinclude>===</noinclude>
Im Prinzip kann jede „Schalterfunktion“ <code><nowiki>__XYZ__</nowiki></code> genauso zu einer Parserfunktion <code><nowiki>{{#xyz}}</nowiki></code> migriert werden.
* Damit wäre die Beschreibung der Wikisyntax konsistenter und die Ausnahmen für das Unterstreichungsstrich-Format könnten perspektivisch beseitigt werden.
* Dies war im ersten Jahrzehnt auch vorgeschlagen worden; wurde jedoch abgelehnt wegen der Befürchtung einer Namenskollision in den Wikis mit einer ''Vorlage:XYZ''.
* Durch den Parserfunktionen einheitlich vorangestelltes <code>#</code> gibt es jedoch keine Namenskonflikte mit eingebundenen Seiten.
Schalterfunktionen stammen aus der frühen Frühzeit der Wikisyntax; dieses Konzept wurde praktisch nicht weiter verfolgt.

<includeonly>====</includeonly><noinclude>===</noinclude> Magische Wörter <includeonly>====</includeonly><noinclude>===</noinclude>
„[[Magische Zahl (Informatik)|Magische Wörter]]“ im eigentlichen Sinn werden nicht an der syntaktischen Notation durch Unterstreichungsstriche oder Klammern erkannt, sondern an einer bestimmten Zeichenkette mitten im Text.
* Das ist für eine syntaktische Beschreibung, die effiziente Interpretation durch Software wie auch Menschen hochproblematisch.
* Bei den [[Uniform Resource Locator|URL]] ist nachvollziehbar, dass durch einfaches Einstreuen in den Quelltext bereits eine automatische Verlinkung ausgelöst werden soll.
** Problematisch ist hier jedoch, ob sich anschließende Satzzeichen (Punkt, Komma, Fragezeichen, Ausrufezeichen, Semikolon) zur wirksamen Adresse zählen sollen oder nicht (sie werden nicht in die URL einbezogen).
Magische Wörter stammen aus der frühen Frühzeit der Wikisyntax; dieses Konzept wurde nicht weiter verfolgt.

{{Hilfe/Weitere Informationen|Liste=
{{MediaWiki|Help:Extension:ParserFunctions}}
{{MediaWiki|Manual:Parser functions}}
* [[Hilfe:Vorlagen]]
* [[Hilfe:Vorlagen/Programmierung]]
* [[Hilfe:Schalterfunktionen]]
* [[Hilfe:Substitution]]
* [[Hilfe:Magische Wörter]]
|NOTOC=<includeonly>3</includeonly>
}}
<includeonly>===</includeonly><noinclude>==</noinclude> Anmerkungen <includeonly>===</includeonly><noinclude>==</noinclude>
<references />
<noinclude>
[[Kategorie:Hilfe:Vorlagen]]
[[Kategorie:Hilfe:Wikisyntax]]
</noinclude>

← Nächstältere Version		Version vom 13. August 2026, 22:07 Uhr
Zeile 33:		Zeile 33:
	** Wenn ein Pflichtparameter erwartet wird, würde die Funktion ohne Doppelpunkt nicht als solche erkannt werden.		** Wenn ein Pflichtparameter erwartet wird, würde die Funktion ohne Doppelpunkt nicht als solche erkannt werden.
	** Ein leerer Parameterwert ist unzulässig; der Doppelpunkt darf nicht das letzte nicht-leere Zeichen sein.		** Ein leerer Parameterwert ist unzulässig; der Doppelpunkt darf nicht das letzte nicht-leere Zeichen sein.
	* {{Anker\|L10N}} Zu einigen Bezeichnern gibt es deutschsprachige [[Lokalisierung (Softwareentwicklung)\|Lokalisierungen]], die eher dort verwendet werden, wo Vorlagenprogrammierung durch Autoren von Artikeln selbst erfolgt. In fortgeschritteneren Bereichen sind auch für den globalen Austausch die generischen, englischsprachigen Bezeichner üblich. Das erleichtert dann auch die Suche in Quelltexten.		* {{Anker\|L10N}} Zu einigen Bezeichnern gibt es deutschsprachige {{WP\|Lokalisierung (Softwareentwicklung)\|Lokalisierungen}}, die eher dort verwendet werden, wo Vorlagenprogrammierung durch Autoren von Artikeln selbst erfolgt. In fortgeschritteneren Bereichen sind auch für den globalen Austausch die generischen, englischsprachigen Bezeichner üblich. Das erleichtert dann auch die Suche in Quelltexten.

	<includeonly>===</includeonly><noinclude>==</noinclude> Parameterwerte <includeonly>===</includeonly><noinclude>==</noinclude>		<includeonly>===</includeonly><noinclude>==</noinclude> Parameterwerte <includeonly>===</includeonly><noinclude>==</noinclude>
Zeile 100:		Zeile 100:
	* Das wurde dann ausgebaut mit Parametern.		* Das wurde dann ausgebaut mit Parametern.
	* Mitte April 2006 wurden die beiden Funktionen <code>#if:</code> und <code>#switch:</code> eingeführt. Erst dadurch wurde eine Programmierung im eigentlichen Sinn möglich, weil erst damit eine Auswertung von Parameterwerten oder anderer Parserfunktionen eine Steuerung des Verhaltens bewirken konnte.		* Mitte April 2006 wurden die beiden Funktionen <code>#if:</code> und <code>#switch:</code> eingeführt. Erst dadurch wurde eine Programmierung im eigentlichen Sinn möglich, weil erst damit eine Auswertung von Parameterwerten oder anderer Parserfunktionen eine Steuerung des Verhaltens bewirken konnte.
	* Die meisten Parserfunktionen gehören zum anerkannten „Kern“ und sind damit auf allen Wikis der [[Wikimedia Foundation\|WMF]] und auch außerhalb verfügbar.		* Die meisten Parserfunktionen gehören zum anerkannten „Kern“ und sind damit auf allen Wikis der {{WP\|Wikimedia Foundation\|WMF}} und auch außerhalb verfügbar.
	** Einzelne Parserfunktionen werden durch bestimmte „Extensionen“ definiert.		** Einzelne Parserfunktionen werden durch bestimmte „Extensionen“ definiert.
	** Manche Extensionen sind auf allen Wikis der WMF aktiviert; einige nur auf bestimmten, etwa zentralen mehrsprachigen usw.		** Manche Extensionen sind auf allen Wikis der WMF aktiviert; einige nur auf bestimmten, etwa zentralen mehrsprachigen usw.
Zeile 115:		Zeile 115:

	<includeonly>====</includeonly><noinclude>===</noinclude> Magische Wörter <includeonly>====</includeonly><noinclude>===</noinclude>		<includeonly>====</includeonly><noinclude>===</noinclude> Magische Wörter <includeonly>====</includeonly><noinclude>===</noinclude>
	„[[Magische Zahl (Informatik)\|Magische Wörter]]“ im eigentlichen Sinn werden nicht an der syntaktischen Notation durch Unterstreichungsstriche oder Klammern erkannt, sondern an einer bestimmten Zeichenkette mitten im Text.		„{{WP\|Magische Zahl (Informatik)\|Magische Wörter}}“ im eigentlichen Sinn werden nicht an der syntaktischen Notation durch Unterstreichungsstriche oder Klammern erkannt, sondern an einer bestimmten Zeichenkette mitten im Text.
	* Das ist für eine syntaktische Beschreibung, die effiziente Interpretation durch Software wie auch Menschen hochproblematisch.		* Das ist für eine syntaktische Beschreibung, die effiziente Interpretation durch Software wie auch Menschen hochproblematisch.
	* Bei den [[Uniform Resource Locator\|URL]] ist nachvollziehbar, dass durch einfaches Einstreuen in den Quelltext bereits eine automatische Verlinkung ausgelöst werden soll.		* Bei den {{WP\|Uniform Resource Locator\|URL}} ist nachvollziehbar, dass durch einfaches Einstreuen in den Quelltext bereits eine automatische Verlinkung ausgelöst werden soll.
	** Problematisch ist hier jedoch, ob sich anschließende Satzzeichen (Punkt, Komma, Fragezeichen, Ausrufezeichen, Semikolon) zur wirksamen Adresse zählen sollen oder nicht (sie werden nicht in die URL einbezogen).		** Problematisch ist hier jedoch, ob sich anschließende Satzzeichen (Punkt, Komma, Fragezeichen, Ausrufezeichen, Semikolon) zur wirksamen Adresse zählen sollen oder nicht (sie werden nicht in die URL einbezogen).
	Magische Wörter stammen aus der frühen Frühzeit der Wikisyntax; dieses Konzept wurde nicht weiter verfolgt.		Magische Wörter stammen aus der frühen Frühzeit der Wikisyntax; dieses Konzept wurde nicht weiter verfolgt.