Help:Magic words/de

Magische Wörter sind Zeichenketten, welche MediaWiki mit einem Ausgabewert oder einer Funktion verbindet, etwa Zeitangaben, Webseiten-Informationen oder Seitennamen. Diese Seite behandelt ausschließlich den Gebrauch regulärer magischer Wörter, eine technische Dokumentation befindet sich unter.

Es gibt drei allgemeine Typen von magischen Wörtern:


 * Verhaltensschalter: sind Wörter, die üblicherweise in Großbuchstaben gesetzt und von doppelten Unterstrichen umschlossen sind, beispielsweise  .
 * Variablen: sind Wörter in Großbuchstaben, umschlossen von doppelten geschweiften Klammer, beispielsweise  . Als solche sehen sie ein wenig aus wie Vorlagen.
 * Parserfunktionen: akzeptieren Parameter und kommen in zwei Formen vor:   oder  , z.B. . Siehe auch und.

Variablen und Parserfunktionen können subst: benutzen, ebenso wie Vorlagen. Seitenabhängige magische Wörter werden in ihrer Wirkung stets die aktuelle Seite berücksichtigen, selbst wenn das Wort über eine eingebundene Vorlage oder Systemnachricht hinzugefügt wird.

Verhaltensschalter
Ein Verhaltensschalter steuert das Aussehen oder Verhalten einer Seite (wenn vom Skin unterstützt) und kann oft verwandt werden, um gewünschte Auslassungen oder Einfügungen im Inhalt vorzugeben. Beachte, dass manche dieser Schalter nicht vom Minerva-Skin unterstützt werden.

Variablen
Variablen geben Informationen über die aktuelle Seite, das Wiki oder das Datum zurück. Ihre Syntax gleicht der von Vorlagen. Als " [aufwendig] " markierte Variablen werden von der Software verfolgt, und ihr Gebrauch auf einer Seite ist in ihrer Zahl begrenzt.

Bei einem Namenskonflikt zwischen Vorlage und Variable wird die Variable benutzt (um doch die Vorlage zu benutzen, müsste dies in der Form  geschehen). In manchen Fällen zwingt ein zusätzlicher Parameter den Parser, statt der Variable eine gleichnamige Vorlage einzubinden, so bindet  etwa     :CURRENTDAYNAME ein.

Zeitangaben
Die folgenden Variablen geben das gegenwärtige Datum oder die Zeit an, abhängig von der in den Benutzereinstellungen gewählten Zeitzone; Standard ist die UTC-Zeitzone.

Aufgrund des MediaWiki- beziehungsweise Browsercache zeigen diese Variablen oft lediglich das Datum des letzten Neuladens an.

Die Verwendung dieser Variablen bewirkt, dass die Seiten für eine begrenzte Anzahl von Sekunden zwischengespeichert werden. Dies wird in MagicWordFactory konfiguriert.

Die magischen Datumsangaben werden in der Sprache des Wikiinhaltes formatiert. Seit, hängt das von page content language ab.

Die folgenden Variablen funktionieren analog wie oben, bloß benutzen sie die Zeitzone der Website oder statt die Benutzereinstellungen.



Um Zeitangaben genauer zu gestalten, oder das aktuelle Jahr und die aktuelle Woche nach ISO-8601 anzupassen, steht die optionale Erweiterung bereit, die mit der -Parser-Funktion kommt.

Statistik
Von den folgenden Variablen zurückgegebene Zahlen werden normalerweise durch Trennzeichen (Kommata beziehungsweise Leerzeichen, je nach lokaler Interfacesprache) getrennt; dieses Verhalten kann mit dem ":R"-Parameter unterdrückt werden (Beispiel:  &rarr;  und   &rarr; ).

Für magische Wörter, wie PAGESINCATEGORY, die einen Parameter benutzen, verwende "|R", z.B.  und , oder   und. Dies kann auch auf  angewendet werden.

Die magischen Zahlenangaben werden in der Sprache des Wikiinhaltes formatiert. Seit, hängt das von page content language ab.

Seitennamen
Nichts davon wird durch Änderungen des Anzeigetitels mit  beeinflusst; die zurückgegebenen Werte sind die ursprünglichen Seitentitel.

Die magischen Wörter  und   funktionieren nur in Namensräumen, für die Unterseiten aktiviert sind. Für weitere Informationen und wie man Unterseiten aktiviert, siehe.

Ab 1.15+ können diese alle einen Parameter annehmen, der die Angabe der zu bedienenden Seite erlaubt, anstatt nur der aktuellen Seite:



URL-kodierte Seitennamen
Die folgenden Wörter sind die URL-kodierten Äquivalente:



Beachte:,   und   haben unteschiedliche Implementierungen. Für Details siehe.

Namensräume
Die folgenden Wörter sind die URL-kodierten Äquivalente:



Ab Version 1.15+ können alle diese Wörter mit einem Parameter verwandt werden, der statt der aktuellen Seite eine beliebige andere spezifiziert:

Der Parameter muss keine Bezeichnung eines Namensraumes sein:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Parserfunktionen
Parserfunktionen sind sehr ähnlich zu Variablen, aber benutzen mindestens einen oder mehrere Parameter (technisch gesehen ist jedes magische Wort, das einen Parameter benötigt, eine Parserfunktion) und haben gelegentlich eine Raute am Anfang des Namens, um sie von Vorlagen zu unterscheiden.

Diese Seite beschreibt nur die Parserfunktionen, die direkt in der MediaWiki-Software integriert sind. Andere Parserfunktionen können von MediaWiki-Erweiterungen hinzugefügt werden, wie. Siehe dazu.

Namensräume
gibt den aktuellen lokalisierten Namen für den Namespace mit diesem Index, dem kanonischen Namen oder dem lokalen Alias zurück. So geben,   und   (ein alter Name für den Namespace File) alle "    " zurück. In einem Wiki, in dem die Sprache des Inhalts Französisch ist, ist  ebenfalls gültig, aber   (die Lokalisierung von "File" in Deutsch) ist es nicht.

ist das Äquivalent, das für MediaWiki-URLs kodiert ist. Es macht dasselbe, ersetzt aber Leerzeichen durch Unterstriche, was es in externen Links verwendbar macht.

Man sollte lokalisierte Namensräume nicht mit den standardisierten Namensräumen verwechseln.

Formatierung
Siehe auch:.

Lokalisierung
Hier sind die Magischen Wörter, die als Hauptlokalisierungswerkzeuge verwendet werden. Andere Magischen Wörter hängen oft von der Sprachumgebung und der Konfiguration des Wikis oder von der gewählten Sprache ab: siehe insbesondere #Date and time und, #Formatting, #Miscellaneous. Weitere Magischen Wörter werden durch das hinzugefügt.

Die Verwendung dieser Magischen Wörter kann sehr komplex sein, und die Dokumentation ist derzeit unvollständig; es gibt einige weitere Informationen auf PLURAL, GRAMMAR, GENDER.

Transclusion-Modifier
schließt normalerweise eine andere Seite ein, die voreingestellt aus dem Template:namespace kommt. Diese magischen Worte ändern dieses Verhalten.

Verschiedenes
Für die Parserfunktion #invoke, siehe w:Wikipedia:Lua.