Hilfe:Variablen: Unterschied zwischen den Versionen

Version vom 18. Mai 2018, 06:56 Uhr

Variablen dienen in MediaWiki (und somit auch in der Wikipedia) dazu, bestimmte Werte, die sich ändern – wie beispielsweise das aktuelle Datum oder die Artikelanzahl –, in Seiten einzufügen. Ebenso wie Vorlagen werden Variablen eingesetzt, indem sie durch doppelte geschweifte Klammern eingefasst werden. Ähnlich den Variablen gibt es Parserfunktionen (parser functions), die im Rahmen der Vorlagenprogrammierung eingesetzt werden, um beispielsweise Bedingungen in Vorlagen zu formulieren. Darüber hinaus gibt es Schalter, sogenannte behavior switches, mit denen das Seitenverhalten bzw. das Anzeigeverhalten bestimmter Seitenbestandteile (wie etwa des Inhaltsverzeichnisses) beeinflusst werden kann. Zu den „magischen Wörtern“ zählen auch #WEITERLEITUNG, ISBN, PMID und RFC; letztlich auch die Internet-Protokolle wie https: am Beginn von URLs. Was genau mit „magisches Wort“ gemeint wird, ist nicht klar festgelegt und wechselt im Lauf der Zeit und bei unterschiedlichen Programmierern der MediaWiki-Software. Im engeren Sinn zählen die von doppelten geschweiften Klammern eingeschlossenen Elemente zu den regulären Syntaxelementen, während die Schalter sowie PMID RFC ISBN und URL eine jenseits der formalen Syntax liegende Magie entfalten.

Die Unterstreichungsstriche gehören zur Syntax der Bezeichner und dürfen nicht wie bei Seitennamen durch Leerzeichen ersetzt werden.

Die Programmierungselemente sollten möglichst sparsam in enzyklopädischen Artikeln verwendet werden, damit auch weiterhin jeder an den Artikeln mitarbeiten kann.

Es wird neben den englischen Namen auch eine der im Folgenden genannten Übersetzungen (Lokalisierungen) nur in Projekten mit Deutsch als Inhaltssprache (deutschsprachige Wikipedia, deutschsprachiges Wikisource usw.) erkannt, die englischsprachigen Bezeichner sind dagegen in allen MediaWiki-Installationen – unabhängig von der Inhaltssprache – möglich.

• Der deutsche Name mag in Artikeln den damit weniger vertrauten Autoren eine Hilfe sein.
• Innerhalb der Vorlagenprogrammierung und technikorientierter Seiten sind dagegen weit überwiegend die englischsprachigen Grundformen üblich, auch um die komplizierte Programmierung zwischen Wiki-Projekten austauschen zu können. Sie sind den Programmierern wesentlich vertrauter und werden sicherer gehandhabt, während in Programmierung nicht geübte Artikel-Autoren hier weder editieren noch dies ohne tieferes Verständnis tun sollten.

Vorlage:Anker Schalter und andere „magische Wörter“

Schalter sind von jeweils zwei Unterstrichen davor und dahinter eingeschlossen und haben keine Parameter. Schalter beeinflussen das Seitenverhalten oder -layout.

Variablen

Generelle, konstante Variablen

Seitenabhängige Variablen

Datums- und Zeitvariablen

Im Folgenden werden die Datums- und Zeitvariablen vorgestellt. Für jede Aufgabe, wie den Namen des Wochentags, gibt es je einen Vertreter mit dem Präfix CURRENT beziehungsweise LOCAL. Die CURRENT-Variablen beziehen sich auf die koordinierte Weltzeit (UTC), die LOCAL-Variablen auf die mitteleuropäische Zeit (MEZ/CET) oder – im Jahr 2024 – zwischen dem Fehler im Ausdruck: Nicht erkanntes Satzzeichen „[“ und dem Fehler im Ausdruck: Nicht erkanntes Satzzeichen „[“ die mitteleuropäische Sommerzeit (MESZ/CEST).

Das hat zur Folge, dass die von den CURRENT-Variablen je nach Winter- oder Sommerzeit ein bis zwei Stunden hinter der von den LOCAL-Variablen angegebenen Zeit zurückliegt, was man vor allem an den Variablen {{CURRENTHOUR}}/{{JETZIGE_STUNDE}} (19) und {{LOCALHOUR}}/{{LOKALE_STUNDE}} (19) sehen kann.

Aufgrund der Methode, mit der MediaWiki und die meisten Browser HTML-Seiten zwischenspeichern, zeigen Zeitvariablen, die sich öfter als einmal pro Tag ändern, den Zeitpunkt der letzten Zwischenspeicherung an, nicht die aktuelle Zeit.

Zähler

Für die Anzahl der Benutzer in Benutzergruppen gibt es die Parserfunktion NUMBERINGROUP, NUMINGROUP (BENUTZER_IN_GRUPPE).

Namensraum-Funktionen

Das Kürzel ns steht für name space, die Lokalisierung ist nr für Vorlage:„NamensraumVorlage:“. Siehe auch Hilfe:Namensräume.

Mithilfe von {{nse:}} oder {{nr_url:}} wird der Namensraum URL-encodiert zurückgegeben.

Trick

Es ist auch möglich {{ns:0}} als leere Variable für Bedingungen ({{#if:}}) zu benutzen. ns:0 ist eine Variable, die den Präfix für den Artikelnamensraum enthält. Da Seiten im Artikelnamensraum kein Präfix haben, ist der Rückgabewert ein leerer Text. Siehe auch Vorlage:NULL.

Vorlage:Anker Hinweise

• 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: wäre nur in einer exklusiv deutschsprachigen Vorlage für den im vorangehenden Abschnitt beschriebenen Trick {{ns:0}} sinnvoll; in allen anderen Fällen unsinnig, sofern nicht ein numerischer Namensraum-Code als Parameter übergeben wurde.
  • 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.

Funktionen

Die folgenden Funktionen sind Bestandteil einer MediaWiki-Basisinstallation. Für spezielle Parserfunktionen, die Bestandteil der MediaWiki-Erweiterung ParserFunctions sind, siehe Hilfe:Vorlagenprogrammierung.

Weitere Informationen

• Hilfe:Spezialseiten #Benutzer (z. B. für Links auf die jeweils eigene Benutzerseite des angemeldeten Benutzers)
• mw:Help:Magic words – Hilfe zu den „magischen Wörtern“ bei Mediawiki (englisch)
• Vorlage:Phab – Quellcode des Moduls (alle „magischen Wörter“, englisch dokumentiert)

Anmerkungen