Hilfe:Parserfunktionen/Text

Diese Hilfeseite zeigt Parserfunktionen zur Arbeit mit Text im Sinne einer Zeichenkette.

Wikisyntax

Wikisyntax kann vor der Auswertung verborgen werden.

Dies sind die einzigen Parserfunktionen mit einem konstanten Ergebnis.

Pipe-Symbol

Funktion
`!`
Pipe-Symbol `\|` generieren.
Beispiel: `{{!}}` → `\|`

Diese Funktion dient dazu, innerhalb der Parameterwerte für Vorlagen und auch Parserfunktionen ein Pipe-Symbol zu verwenden, ohne dass es in der ersten Auswertung als Trenner zwischen Parameterwerten wirkt.

Im Ergebnis ist es dann syntaktisch wirksam und ein normales Pipe-Symbol. Das wird für die Tabellensyntax benötigt, falls diese in Parameterwerte einfließen soll.
Wenn nur die dekorative Wirkung in der Darstellung angestrebt wird, kann auch das HTML-Entity | verwendet werden.

Gleichheitszeichen

Funktion
`=`
Gleichheitszeichen `=` generieren.
Beispiel: `{{=}}` → `=`

Diese Funktion dient dazu, innerhalb der Parameterzuweisungen für Vorlagen und auch Parserfunktionen ein Gleichheitszeichen zu verwenden, ohne dass es in der ersten Auswertung als Bezeichner für Parameternamen wirkt.

Im Ergebnis ist es dann syntaktisch wirksam und ein normales Gleichheitszeichen.

Das Problem tritt insbesondere dann auf, wenn unbenannten Parametern einer Vorlage ein Wert zugewiesen wird, der ein Gleichheitszeichen enthält. Hier gibt es zwei Möglichkeiten:

Parameternamen voranstellen:
|1=<span class="hintergrundfarbe8">Überschrift</span>
Alle = im Wert einzeln maskieren:
|<span class{{=}}"hintergrundfarbe8">Überschrift</span>

Wenn nur die dekorative Wirkung in der Darstellung angestrebt wird, kann auch das HTML-Entity = verwendet werden.

Groß- und Kleinschreibung

Diese Funktionen wirken auf alle Buchstaben in allen Schriftsystemen, die das Konzept von Groß- und Kleinbuchstaben kennen.

Funktion	Lokalisierung	Pflichtparameter
`lc`	`klein`	Textfragment
Alle Buchstaben in Kleinbuchstaben wandeln.
Beispiel: `{{lc:CamelCasing}}` → `camelcasing`
`lcfirst`	`initial_klein`	Textfragment
Ersten Buchstaben in Kleinbuchstaben wandeln.
Beispiel: `{{lcfirst:CamelCasing}}` → `camelCasing`
`uc`	`gross`	Textfragment
Alle Buchstaben in Großbuchstaben wandeln.
Beispiel: `{{uc:CamelCasing}}` → `CAMELCASING`
`ucfirst`	`initial_gross`	Textfragment
Ersten Buchstaben in Großbuchstaben wandeln.
Beispiel: `{{ucfirst:CamelCasing}}` → `CamelCasing`

Ausrichten (padding)

Diese Funktionen ermöglichen das Einfügen von Zeichen, um in einer geeigneten Darstellung ggf. die Ziffer Null oder auch Leerzeichen so einzufügen, dass alle Zeichenketten die vorgegebene Länge erhalten.

Funktion	Lokalisierung	Pflichtparameter
`padleft`	`füllenlinks`	Textfragment	Länge	Füllzeichen
Linksbündig mit Füllzeichen auffüllen, bis mindestens Länge erreicht ist.
Beispiel: `{{padleft:1234\|6\|0}}` → `001234`
`padright`	`füllenrechts`	Textfragment	Länge	Füllzeichen
Rechtsbündig mit Füllzeichen auffüllen, bis mindestens Länge erreicht ist.
Beispiel: `{{padright:5,67\|6\|0}}` → `5,6700`

Als Füllzeichen können auch mehrere Zeichen angegeben werden; aber die Mindestlänge führt dann ggf. zu unerwarteten Ergebnissen:

"{{padright:Haus|7| }}" → "Haus&nb"

Werte kleiner oder gleich Null oder nichtnumerische Angaben für die Länge und fehlende Textfragmente liefern ggf. seltsame Effekte.

Plural und Singular

Funktion	Pflichtparameter
`plural`	Anzahl	Singularform	Pluralform
Text in grammatikalisch korrekter Schreibung abhängig von der Anzahl. Wenn die Anzahl den Wert `1` hat, wird die Singularform zurückgegeben. Wenn die Anzahl mehr als eins liefert, wird die Pluralform zurückgegeben. In anderen Projektsprachen kann es weitere sprachbezogen definierte Parameter geben, wenn diese einen Paukal, Dual, Trial usw. kennen.
Beispiele: `{{plural:1\|Kuh\|Kühe}}` → `Kuh` `{{plural:5\|Kuh\|Kühe}}` → `Kühe`

Wenn die Anzahl kleiner als eins oder nicht numerisch ist, lässt sich das Verhalten nicht dauerhaft vorhersagen. Es kann die Pluralform oder „nichts“ resultieren.

Konkurrierend zu dieser Parserfunktion gibt es eine Vorlage gleichen Namens, die dadurch aktiviert wird, dass der erste Parameter durch | statt : abgetrennt wird:

{{plural|1|Kuh|Kühe}} → 1 Kuh
{{plural|5|Kuh|Kühe}} → 5 Kühe

Hier wird die Anzahl wiederverwendet und mittels eines geschützten Leerzeichens vorangestellt.

Vorlage:Mehrzahl wäre allerdings ein glücklicherer Name gewesen und hätte verdeutlicht, dass es sich offenkundig um etwas anderes handelt.

Geschlecht

Funktion	Lokalisierung	Pflichtparameter			Parameter
`gender`	`geschlecht`	Konto	Text männlich	Text weiblich	Text unbekannt
Textvariante abhängig von der momentanen persönlichen Einstellung eines Benutzerkontos darstellen. Wenn das Konto als explizit männlich oder weiblich konfiguriert wurde, wird die entsprechende Variante dargestellt. Wenn das Konto nicht bekannt ist oder keine explizite Wahl getroffen wurde, wird die Variante „unbekannt“ dargestellt. Wenn die (erst später ermöglichte) „unbekannt“-Variante nicht vorgegeben ist, wird die „männlich“-Version für diesen Fall benutzt.
Beispiele: `{{gender:Beispielnutzer\|m\|w\|u}}` → `u` des Benutzer:Beispielnutzer (generisch). `{{gender:Beispielnutzerin\|m\|w\|u}}` → `w` der Benutzerin:Beispielnutzerin. `{{gender:Beispielnutzer (m)\|m\|w\|u}}` → `m` des Benutzer:Beispielnutzer (m). `{{gender:Beispielnutzer\|m\|w}}` → `m` des Benutzer:Beispielnutzer ohne „unbekannt“-Variante. `{{gender:123.456.789.012\|m\|w\|u}}` → `u` für nicht registrierten Nick (IP-Adresse).

Formale Sprachvariante

Im Mai 2024 neu eingeführt wurde die nachstehende Unterscheidung gemäß persönlicher Spracheinstellung.

Funktion	Pflichtparameter
`#FORMAL`	informeller Ausdruck	formeller Ausdruck
Textvariante abhängig von der momentanen persönlichen Einstellung eines Benutzerkontos darstellen. Wenn das Konto für eine formale Sprachvariante konfiguriert wurde, wird die entsprechende Fassung dargestellt. Anders als bei den meisten Parserfunktionen ist zunächst die Großschreibung des Schlüsselworts erforderlich.
Beispiel: `{{#FORMAL:du\|Sie}}` → du `Sie` für die Auswahl `de-formal` `du` sonst

Aufzählung

Funktion	Pflichtparameter	Parameter
`#commaSeparatedList`	Item1	Item2	Item3	…
Komma-separierte Liste von Elementen. Item1 – erstes Element Item2 – zweites Element Item3 – drittes Element …
Beispiel: `{{#commaSeparatedList:a\|b\|c}}` → `a, b, c`
Die Funktion entstammt mw:Extension:Wikibase Client.

Grammatik

Für diese Funktion ist deutschsprachig zurzeit keine Programmierung hinterlegt.

Funktion
`grammar`
Sprachabhängige Modifikation (Beugung, Verb/Substantiv usw.)

Schreibrichtung

Diese Funktionen werden in der deutschsprachigen Wikipedia nicht verwendet.

Es sind die sprach- und schriftspezifischen Vorlagen der Kategorie:Vorlage:zur Schriftunterstützung (bidi) zu benutzen.
Diese Methodik mit Steuerzeichen ist seit längerer Zeit unerwünscht und entstammt dem vorigen Jahrhundert.
Moderne Techniken verwenden HTML-Elemente für die Inhalte und weisen ihnen entsprechende Attribute zu.

Funktion	Pflichtparameter
`bidi`	Textfragment
Bidirektionaler Text. Textfragment (hier: Rechts-Links-Schreibrichtung) Es wird in einem Projekt mit Links-Rechts-Schreibrichtung banal `&rlm;` und `&lrm;` davor und dahinter geschrieben.
`DIRECTIONMARK` `DIRMARK`
Reguläre Schreibrichtung sicherstellen. Es wird in einem Projekt mit Links-Rechts-Schreibrichtung banal `&lrm;` eingefügt. Damit sollten nach Einfügung unbekannter Textfragmente unerwünschte Effekte auf den nachfolgenden Text vermieden werden.

Inhaltsverzeichnis