Erweiterung:Variables

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Variables and the translation is 100% complete.

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎Tiếng Việt • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎sicilianu • ‎suomi • ‎русский • ‎中文 • ‎日本語 • ‎한국어
MediaWiki-Erweiterungen
Crystal Clear action run.svg
Variables
Erscheinungsstatus: stabil
Einbindung Parser function
Beschreibung Führt Parser-Funktionen zum Umgang mit seitenbezogenen Variablen ein.
Autor(en)
Betreuer MGChecker
Letzte Version 2.5.0 (2018-08-31)
MediaWiki 1.29+
PHP 5.5+
Datenbankänderungen Nein
Lizenz ISC License
Herunterladen
README
RELEASE-NOTES
Verwendete Hooks
ParserFirstCallInit
ParserClearState
InternalParseBeforeSanitize
Übersetze die Variables Erweiterung wenn sie auf translatewiki.net verfügbar ist
Prüfe die Benutzungs- und Versionsmatrix.
Vagrant-Rolle variables
Probleme Offene Aufgaben · Einen Fehler melden

Die Erweiterung Variables ermöglicht es dir, auf einer Seite eine Variable zu definieren, sie später auf derselben Seite oder in darauf eingebundenen Vorlagen zu verwenden, ihren Wert zu verändern; eventuell zu einem Wert, der relativ zu dem vorherigen ist, usw.

Es verhält sich wie eine Vorlage, nur abgespeckt und nur auf eine einzige Seite bezogen, so dass auf einer Seite viele Variablen benutzt werden können, ohne das Wiki mit vielen Vorlagen zu verlangsamen. Für die besten Resultate zusammen mit der Erweiterung ParserFunktionen verwenden.

Einer Variablen einen Wert zuordnen

#vardefine

  • {{#vardefine:VariablenName|AngegebenerWert}}

Weist den Wert AngegebenerWert der (schon existierenden oder hiermit eingeführten) Variablen VariablenName zu.

  • Beispiel: {{#vardefine:iconwidth|25}} setzt iconwidth = 25

#vardefineecho

  • {{#vardefineecho:VariablenName|AngegebenerWert}}

Funktioniert genauso wie #vardefine, aber der betroffene Wert wird ausgegeben.

  • Beispiel: making iconwidth = <code>{{#vardefineecho:iconwidth|25}}</code>

Auslesen des Wertes einer Variablen

#var

Der Wert der Variablen VariablenName wird ausgelesen durch

  • {{#var:VariablenName}}

Wenn VariablenName nicht definiert ist, wird eine leere Zeichenkette ausgegeben. Es gibt keine Fehlermeldung.

Es ist möglich, einen Wert für den Fall anzugeben, dass die Variable undefiniert oder leer ist:

  • {{#var:VariablenName | Standardwert }}

Dies ist gleichbedeutend mit:

  • {{#if: {{#var:VariablenName}} | {{#var:VariablenName }} | Standardwert }}

ist aber wesentlich kürzer und besser strukturiert. Vor Version 2.0 wurde der Standardwert immer expandiert. Seit Version 2.0 wird der Standardwert nur noch expandiert, wenn er tatsächlich benutzt wird.

Der Wert kann in Parser-Funktionen usw. benutzt werden.

#varexists

  • {{#varexists:VariablenName }} gibt 1 aus, wenn die Variable bereits definiert ist. Wenn die Variable nicht definiert ist, so wird ein leerer Wert ausgegeben.

Sie unterstützt eomem zweiten und einen dritten Parameter, um diese Werte zu übersetzen.

  • {{#varexists: VariablenName | wenn-Wert | sonst-Wert }}

Dies ist gleichbedeutend mit:

  • {{#if: {{#varexists: VariablenName }} | wenn-Wert | sonst-Wert }}

ist aber wesentlich kürzer und besser strukturiert. Vor Version 2.5 wurden beide Werte immer expandiert. Seit Version 2.5 werden wenn- und sonst-Wert nur noch expandiert, wenn ihre Fälle tatsächlich eintreten.

#var_final

Experimentelle neue Funktion, die mit Variables 2.0 eingeführt wurde. Diese Funktion gibt den letzten Wert aus, den eine Variable hat, nachdem die Seite vollständig gerendert wurde. Naturgemä0 wird dieser Wert erst eingefügt nachdem der Parser den vollständigen Wiki-Code verarbeitet hat, also kann diese Funktion nicht innerhalb anderer Funktionen genutzt werden, da der richtige Wert zu diesem Zeitpunkt noch nicht bekannt ist. Beispiel:

  • {{#var_final:VariablenName | Standardwert}}

Der Standardwert wird benutzt, wenn die Variable zum Zeitpunkt, an dem das Rendern abgeschlossen ist, nicht existiert oder sein Wert aus einer leeren Zeichenkette besteht. Der Standardwert wird an genau der Stelle expandiert, an der die Funktion benutzt wurde, genauso werden die Parameter expandiert, selbst wenn sie nicht gebraucht werden.

Beispiele

Um #expr benutzen zu können, muss auch die ParserFunctions-Erweiterung installiert sein.

Berechne x = 2*a + b:

  • {{#vardefine:x|{{#expr:2*{{#var:a}}+{{#var:b}}}}}}

Erhöhe n um eins:

  • {{#vardefine:n|{{#expr:{{#var:n}}+1}}}}

Installation

  • Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
    wfLoadExtension( 'Variables' );
    
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.

An Nutzer, die MediaWiki 1.30 und früher betreiben:

Die oben stehenden Anweisungen beschreiben den neuen Weg der Installation von diese Erweiterung per wfLoadExtension(). Falls du diese Erweiterung in einer dieser früheren Versionen (MediaWiki 1.30 und früher)  – an Stelle von wfLoadExtension( 'Variables' ); – installieren musst, benutze:

require_once "$IP/extensions/Variables/Variables.php";

Kompatibilität

Die empfohlene Version der Variables-Erweiterung für neuere MediaWiki-Versionen fimdet sich unten. Ältere Versionen der Erweiterung können ebenfalls funktionieren, werden jedoch für neue MediaWiki-Versionen nicht getestet.

Anmerkung

Siehe auch