Wikonia

Hilfe:Vorlagenprogrammierung/Parserfunktionen/Struktur und Titel

< Hilfe:Vorlagenprogrammierung | Parserfunktionen

Parserfunktionen zur Struktur und Titelauswertung ermöglichen es, Seitentitel, Pfade und Anker gezielt zu zerlegen, umzuwandeln oder in andere Formen zu überführen. Sie machen sichtbar, welche strukturellen Informationen MediaWiki intern aus Titeln und URLs ableitet – und was sich daraus weiterverwenden lässt.

Hilfebereich bei Wikonia
Hilfebereich bei Wikonia

Hilfebereich

Benutzerkonto
Navigation & Suche
Seitenbearbeitung
Seitenorganisation
Vorlagen & Module
Diskussionen & Anträge
Gadgets
Phorge

Diese Seite zeigt, welche Möglichkeiten es dafür gibt und wo die jeweiligen Funktionen sinnvoll eingesetzt werden können. Behandelt werden ausschließlich echte Parserfunktionen mit :-Syntax.

Magische Wörter zur Titelauswertung werden hier nicht beschrieben, sie können zur Ergänzung der hier beschriebenen Funrkionen jedoch sehr nützlich sein..

Die hier beschriebenen Funktionen sind kein Ersatz für Logik oder Navigation, sondern Werkzeuge zur strukturierten Weiterverarbeitung von bereits vorhandenen Informationen.

#titleparts – Zerlegung von Seitentiteln Bearbeiten

Die Parserfunktion zerlegt einen Seitentitel in einzelne Bestandteile und gibt ausgewählte Teile davon zurück. Sie eignet sich zur strukturellen Auswertung von Haupt- und Unterseiten.

Funktion Parameter Optionale Parameter
#titleparts Seitentitel Anzahl Start

Funktionsweise Bearbeiten

#titleparts zerlegt den angegebenen Seitentitel anhand des Schrägstrichs (/) in einzelne Teile. Anschließend werden – abhängig von den Parametern – bestimmte Teile des Titels zurückgegeben.

Der Parameter Anzahl bestimmt, wie viele Teile ausgegeben werden. Der Parameter Start legt fest, ab welchem Teil gezählt wird.

Wird Anzahl nicht angegeben oder auf 0 gesetzt, werden alle verfügbaren Teile berücksichtigt. Ein negativer Wert zählt die Teile von rechts.

Der Parameter Start kann ebenfalls negativ sein und bezieht sich dann auf die Zählung vom Ende des Titels.

Beispiele Bearbeiten

{{#titleparts: Hilfe:Parserfunktionen/Struktur und Titel }}

Gibt den vollständigen Seitentitel unverändert zurück.

{{#titleparts: Hilfe:Parserfunktionen/Struktur und Titel | 1 }}

Gibt nur den ersten Teil des Titels zurück (Hilfe:Parserfunktionen).

{{#titleparts: Hilfe:Parserfunktionen/Struktur und Titel | -1 }}

Gibt den letzten Teil des Titels zurück (Struktur und Titel).

{{#titleparts: Hilfe:Parserfunktionen/Struktur und Titel | 1 | 1 }}

Gibt den zweiten Teil des Titels zurück.

Typische Fehler und Besonderheiten Bearbeiten

#titleparts arbeitet ausschließlich mit der Struktur des Titels. Groß- und Kleinschreibung, Leerzeichen und Sonderzeichen werden nicht normalisiert.

Der Trenner ist fest der Schrägstrich (/). Andere Zeichen oder Namensraumtrenner werden nicht berücksichtigt.

Negative Werte für Anzahl oder Start zählen von rechts. Dies ist funktional, kann die Lesbarkeit aber deutlich verringern.

anchorencode – Ankertext erzeugen Bearbeiten

Die Parserfunktion wandelt Text so um, dass er als Anker (z. B. für Abschnittslinks) zuverlässig verwendet werden kann. Sie eignet sich insbesondere für Links auf Überschriften oder automatisch erzeugte IDs.

Funktion Parameter Optionale Parameter
anchorencode Text — —

Funktionsweise Bearbeiten

anchorencode erzeugt aus beliebigem Text eine Form, die sich als Anker-Teil in Links verwenden lässt. Dabei werden Sonderzeichen so behandelt, dass der resultierende Text stabil für Anker und Abschnittsverweise ist.

Beispiele Bearbeiten

{{anchorencode: Ein Abschnitt }}

Erzeugt einen Ankerwert für die Überschrift „Ein Abschnitt“.

[[#{{anchorencode: Ein Abschnitt }}|Zum Abschnitt]]

Erstellt einen Link auf einen Abschnitt, ohne den Anker „per Hand“ bauen zu müssen.

{{anchorencode: Überschrift mit Umlaut & Zeichen }}

Behandelt Sonderzeichen so, dass der Anker dennoch verlinkbar bleibt.

Typische Fehler und Besonderheiten Bearbeiten

anchorencode ist nicht dasselbe wie urlencode. Die Funktion

urlencode – URL-kodierten Text erzeugen Bearbeiten

Die Parserfunktion kodiert Text so, dass er sicher in URLs verwendet werden kann. Sie wird insbesondere für externe Links, Query-Parameter oder technische Schnittstellen eingesetzt.

Funktion Parameter Optionale Parameter
urlencode Text Typ —

Funktionsweise Bearbeiten

urlencode wandelt Sonderzeichen in eine URL-kodierte Form um. Dadurch wird sichergestellt, dass der Text in URLs korrekt interpretiert wird und keine Syntaxfehler verursacht.

Optional kann ein Typ angegeben werden, der beeinflusst, wie Leerzeichen und Sonderzeichen kodiert werden (z. B. für Query-Parameter oder Pfadbestandteile).

Beispiele Bearbeiten

{{urlencode: Ein Text mit Leerzeichen }}

Kodiert den Text für die Verwendung in einer URL.

{{urlencode: Ein Text mit Leerzeichen | QUERY }}

Kodiert den Text für die Verwendung als Query-Parameter.

https://example.org/?q={{urlencode: Suche mit Umlaut }}

Erzeugt einen technisch korrekten Suchparameter für eine externe URL.

Typische Fehler und Besonderheiten Bearbeiten

urlencode kodiert Text für URLs, nicht für Anker oder Abschnittslinks. Für Abschnittsverweise sollte stattdessen anchorencode verwendet werden.

Die Kodierung ist technisch korrekt, aber nicht menschenlesbar. Für Anzeigezwecke sollte das Ergebnis nicht direkt ausgegeben werden.

urldecode – URL-kodierten Text zurückwandeln Bearbeiten

Die Parserfunktion wandelt URL-kodierten Text wieder in seine lesbare Form zurück. Sie ist das Gegenstück zu urlencode und wird vor allem bei der Weiterverarbeitung technischer Parameter verwendet.

Funktion Parameter Optionale Parameter
urldecode Text — —

Funktionsweise Bearbeiten

urldecode dekodiert einen zuvor URL-kodierten Text. Prozentkodierte Zeichen werden dabei wieder in ihre ursprünglichen Zeichen umgewandelt.

Beispiele Bearbeiten

{{urldecode: Ein%20Text%20mit%20Leerzeichen }}

Wandelt URL-kodierte Leerzeichen wieder in normale Leerzeichen um.

{{urldecode: %C3%9Cberschrift }}

Dekodiert Sonderzeichen wie Umlaute.

Typische Fehler und Besonderheiten Bearbeiten

urldecode sollte nur auf tatsächlich URL-kodierten Text angewendet werden. Wird normaler Text dekodiert, bleibt er unverändert.

Die Funktion ist nicht für Anker oder Abschnittslinks gedacht. Für solche Zwecke ist anchorencode das passende Werkzeug.

rel2abs – relative URLs auflösen Bearbeiten

Die Parserfunktion wandelt eine relative URL in eine absolute URL um. Sie arbeitet auf vollständigen Pfadangaben und dient der technischen Weiterverarbeitung von Links.

Funktion Parameter Optionale Parameter
rel2abs Relativer Pfad Basis-URL —

Funktionsweise Bearbeiten

rel2abs berechnet aus einem relativen Pfad eine absolute URL. Als Basis dient entweder die angegebene Basis-URL oder – falls nicht angegeben – der Kontext der aktuellen Seite.

Beispiele Bearbeiten

{{rel2abs: ../bild.png | https://example.org/pfad/seite.html }}

Erzeugt eine absolute URL aus einem relativen Pfad und einer expliziten Basis.

{{rel2abs: ./datei.pdf | https://example.org/downloads/ }}

Löst einen relativen Pfad innerhalb eines gegebenen Basisverzeichnisses auf.

Typische Fehler und Besonderheiten Bearbeiten

rel2abs arbeitet mit URLs und Pfaden, nicht mit Wiki-Seitenlinks. Relative Wikilinks wie [[../]] gehören zur Linksyntax und werden hiervon nicht berührt.

In normalen Wiki-Seiten wird rel2abs selten benötigt. Die Funktion ist vor allem für technische Sonderfälle und externe Verarbeitungen gedacht.

Siehe auch

Abgerufen von „https://wiki.wikonia.net/index.php?title=Hilfe:Vorlagenprogrammierung/Parserfunktionen/Struktur_und_Titel&oldid=3242“