Hilfe:Parserfunktionen/Seite und URL

Diese Hilfeseite zeigt Parserfunktionen in Bezug auf eine einzelne Seite im Wiki und (auch ihrer) URL sowie der Namensräume.

Die nachstehenden Funktionen beziehen sich in der Regel auf die aktuell dargestellte Seite.

• Einige erlauben es, über einen zusätzlichen Parameter Seitenname auch andere Seiten anzusprechen.
• Ein dem generischen Funktionsnamen nachgestelltes E als Ende des Namens steht für „Encoding“ und bewirkt ein URL-Encoding.

Mit Ausnahme der letzten beiden Funktionen werden Eigenschaften abgefragt.

DISPLAYTITLE wird nicht beachtet, selbst wenn es auf derselben Quelltext-Seite definiert wäre.

Es handelt sich um eine reine Analyse der Zeichenketten unter Beachtung der Namensräume des aktuellen Wiki. Deshalb muss die Seite auch nicht existieren; allerdings der Name aus hierfür gültigen Zeichen bestehen.

Siehe auch Namensräume.

Bei Unterseiten können die Komponenten betrachtet werden, also die durch Schrägstrich / in Segmente gegliederte Hierarchie.

• Siehe dazu auch #titleparts mit mehr Möglichkeiten für einen beliebigen Seitennamen.
• Erforderlich ist ein Namensraum, für den die Unterseiten-Funktionalität aktiviert ist (nahezu alle außer ANR und Mediendateien).

ROOTPAGENAME ist gut geeignet, um das Benutzerkonto zu irgendeiner Seite im BNR festzustellen: {{ROOTPAGENAME:BD:Beispielnutzer/Archiv}} → Beispielnutzer

Alle Funktionen in diesem Abschnitt gehören zu den „teuren“ Funktionen, von denen pro dargestellter Seite gemäß Vorlagenbeschränkungen insgesamt nur 500 erlaubt sind.

Zur Seiteninhaltssprache siehe PAGELANGUAGE.

Die Angaben beziehen sich auf die letzte sichtbare gespeicherte Bearbeitung (aktuelle Version).

• In der Vorschau auch ggf. bei einer neu zu erstellenden Seite wird die Situation bei der Generierung dargestellt, falls nicht anders angegeben.
• Zeitangaben beziehen sich auf die lokale Zeit (Berlin).
• Bei nicht existierendem Seitenname wird ein leerer Wert geliefert.
• Ein nicht existierender Seitenname wird als fehlerhafte Vorlageneinbindung registriert.

Alle Funktionen in diesem Abschnitt gehören zu den „teuren“ Funktionen, von denen pro dargestellter Seite gemäß Vorlagenbeschränkungen insgesamt nur 500 erlaubt sind.

Eine Substitution der Versionsnummer zum Fixieren der aktuellen Seitenversion ist grundsätzlich nicht möglich:

• Zuerst erfolgen alle Substitutionen, und der fertige Wikitext wird hergestellt.
• Danach wird dieser Text in die Warteschlange der Datenbank zur Abspeicherung eingereiht.
• Danach wird der Text abgespeichert und gleichzeitig die laufende Versionsnummer vergeben.
• Damit kann er aber nicht mehr diese aktuelle Versionsnummer enthalten.

Unproblematisch sind Benutzerkonto und Zeitstempel. Sie lassen sich über Tilden oder Substitution der Parserfunktionen gewinnen und sind ja schon vor der Abspeicherung bekannt, zumindest bis auf Zehntelsekunden.

Zur aktuellen Seite kann der korrespondierende Namensraum festgestellt werden. Das bedeutet:

• Die Diskussionsseite zu einer inhaltlichen Seite ist die Diskussionsseite.
  • Die Nummer des Namensraums erhöht sich also um 1, wenn sie vorher ≥0 war.
• Die Diskussionsseite zu einer Diskussionsseite ist die Diskussionsseite selbst.
• Die inhaltliche Seite zu einer Diskussionsseite ergibt sich, indem von der Nummer des Namensraums 1 abgezogen wird; also die sogenannte „Vorderseite“.
• Die inhaltliche Seite zu einer inhaltlichen Seite ist die Seite selbst.
• Für eine Spezialseite gilt:
  • Der zugeordnete inhaltliche Namensraum ist Spezial: selbst.
  • Die zugeordnete inhaltliche Seite ist der (gültige) Parameterwert.
  • Zugeordnete Diskussionsseite und Namensraum sind „leer“.
  • Im Kontext einer Systemnachricht könnte diese Situation einmal auftreten.

Die nachstehenden Funktionen ermitteln zunächst den Namensraum insgesamt.

• Der hier verwendete Begriff „Hauptnamensraum“ darf nicht mit dem ANR oder Hauptnamensraum des Projekts verwechselt werden (Namensraum-Nummer „Null“).

Eine zugeordnete Seite hat den gleichen Seitentitel im zugeordneten Namensraum.

• Der Ausdruck „Hauptseite“ ist verwirrrend gewählt. Gemeint ist nicht die Wikipedia:Hauptseite, sondern die inhaltliche „Vorderseite“ als Gegenstück zur Diskussionsseite.

Während alle vorstehenden Funktionen Eigenschaften der aktuellen Seite erfragen, weist diese und die nächste eine Eigenschaft zu. Zu den Einzelheiten siehe Hilfe:SEITENTITEL.

Anders als fast alle vorstehenden Funktionen, die Eigenschaften der aktuellen Seite erfragen, weist diese ebenfalls eine Eigenschaft zu. Zu den Einzelheiten siehe Hilfe:Kategorien.

Siehe auch Komponenten für die momentane Seite.

Die Funktion ist nur für Seitennamen ausgelegt. Daher funktioniert die Funktion nur mit Zeichen, die auch im Seitennamen erlaubt sind. Im Fehlerfall wird der gesamte Parameter zurückgegeben.

Bevor 2013 mit Lua effiziente Zeichenketten-Operationen verfügbar wurden, ist diese Funktion auch für andere inhaltliche Anwendungen zweckentfremdet worden; etwa für LCCN in einer privaten Gliederung mittels Schrägstrichen.

Es ist möglich, direkt per [[../]] auf Seiten relativ zur aktuellen Seite zu verlinken, sofern Unterseiten aktiviert sind, und genauso auch Seiten einzubinden, ohne ihren vollständigen Namen anzugeben. In manchen Fällen ist es jedoch notwendig, den relativen in einen absoluten Seitennamen zu wandeln.

Die nachstehende Funktion betreibt reine Zeichenkettenverarbeitung; die Seiten müssen nicht wirklich existieren, allerdings müssen die Angaben formal richtig sein.

Ein relativer Seitenpfad kann . oder .. lauten oder beginnen mit /oder ./ oder ../.

Lokalen Standard-Namen eines Namensraums feststellen.

Zur Aufzählung der einzelnen Namensräume in der deutschsprachigen Wikipedia siehe Hilfe:Namensräume.

• Um festzustellen, ob die momentane Seite in einem bestimmten Namensraum liegt, ist {{NAMESPACENUMBER}} mit dem Zahlenwert (etwa 10 für „Vorlage“) zu vergleichen.
  • Nicht sinnvoll ist es, zu vergleichen: {{NAMESPACE}} mit {{ns:10}} – dies führt nur zu einem überflüssigen Funktionsaufruf und zur Ausdehnung von Zeichenketten.
  • Wenn schon mit der global einheitlichen, aber nicht intuitiven Zahl 10 verglichen wird, dann kann das gleich auf Ebene der Zahlen geschehen und muss nicht erst mühsam in die lokalen Namen umgewandelt werden.
  • Wenn in einer nur für den deutschsprachigen Raum geschriebenen Vorlage intuitiv verständlich verglichen werden soll, dann {{NAMESPACE}} direkt mit der Zeichenkette Vorlage (dem Ergebnis von {{ns:10}}).
• Die Form {{nr: statt {{ns: ist nicht sinnvoll.
  • Die Funktionen {{ns: für den Namensraum sind dazu da, in einem nicht-deutschsprachigen Wiki die Vorlagenprogrammierung verwenden zu können, indem die dort geltenden Bezeichnungen der Namensräume dem Benutzer sichtbar gezeigt werden.
  • Wenn es ein nicht-deutschsprachiges Wiki ist, dann ist die Form {{nr: dort unbekannt.
  • Wenn es ein deutschsprachiges Wiki ist, sind die Bezeichnungen der Namensräume bekannt. Dann können die Namen direkt benutzt werden und der Umweg über die nr:-Funktion ist sinnlos.
  • Wenn den Benutzern die Bezeichnung nicht optisch dargestellt werden soll, kann intern in einer weltweit austauschbaren Vorlage direkt mit den englischen Bezeichnungen zur Bildung von Wikilinks oder URL gearbeitet werden, etwa Template_talk: – ein Umweg über die lokalen Namensraumfunktionen aus der Tabelle ist nicht erforderlich.
• Die Form {{nr:Hilfe}} ist absoluter Nonsens im Quadrat; sie kann aus doppeltem Grund nur in einem deutschsprachigen Wiki benutzt werden und hat immer – Hilfe als Ergebnis.
  • Die Form {{ns:Help}} wäre dagegen eine intuitiv verständlichere Form von {{ns:12}} und dient dazu, in einer weltweit austauschbaren Vorlage den lokalen Namen sichtbar darzustellen.
• Siehe ansonsten auch oben Namensraum zu weiteren Konvertierungsmöglichkeiten.

Wenn nur die Verlinkung der Mediendatei in Standardgröße ohne genauere Angaben benötigt wird, ist das Format [[Media:]] günstiger, das bei fehlerhaftem Dateinamen ein Rotlink zeigt, während das URL-Link immer blau ist. Der Dateiname über upload-URL erscheint nicht auf Special:GlobalUsage, was zur Folge hat, dass dieser Link bei Namensänderungen auf Commons (oder lokal) nicht berücksichtigt werden kann.

Direkt in Seiten sollte dies nicht verwendet werden.

Die nachstehenden Funktionen zielen darauf ab, zu einer Wiki-Seite eine URL zu generieren und ggf. auch noch einen oder mehrere URL-Parameter angeben zu können.

• Nur die Variante canonicalurl sollte verwendet werden.
• Die deutschsprachigen Lokalisierungen sind extrem ungebräuchlich und auch missverständlich.

canonicalurl

• bewirkt das URL-Encoding des Seitennamens,
• sorgt für kürzeren Quelltext,
• macht Verlinkungen robuster gegenüber unterschiedlichen Domains.
  • Zwar wird bislang nicht zwischen Mobil- und Desktop-Domain unterschieden, jedoch wird dies erörtert.
• Eine Vorlagenprogramierung ist darüberhinaus zwischen Wikis austauschbar, wenn sie nicht die Domain des momentanen Wikis fest kodiert enthalten muss.

Die nachstehenden Funktionen waren in den allerersten Jahren dafür gedacht gewesen, eine Spezialität der Wiki-URL zu unterstützen.

• Sie hatten noch ein zusätzliches URL-Encoding ausgeführt; das e am Ende des Namens steht für „Encoding“.
• Es ging um Detailfragen der Kodierung von Leerzeichen (Pluszeichen) und Unicode-Zeichen, sowie bei ungültigem Seitennamen.
• Heute ist dies obsolet; ältere Programmierungen sollten zurückgebaut werden.
• Die Wirkung ist gleich der regulären Funktion.

Die nachfolgende Funktion wurde früher benötigt, weil bis Mitte der 2010er Jahre aus Kompatibilitätsgründen für einige Browser die Fragmentbezeichner für ein Wiki nach einem anderen Schema kodiert wurden. Heutzutage ist dies nicht mehr erforderlich, und urlencode kann auch für Fragmentbezeichner verwendet werden. Allerdings müssen Pfad und Fragmentbezeichner separat kodiert werden, weil das kennzeichnende # ansonsten als %23 versteckt würde. Die Funktion sollte zur besseren Verständlichkeit ggf. ersetzt werden; sie führt auch nur einen nicht völlig sicheren Zwischenschritt aus.