Hilfe:Variables: Unterschied zwischen den Versionen

Aus PokéWiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 62: Zeile 62:


=== Variables, die nur in einer Vorlage verwendet werden ===
=== Variables, die nur in einer Vorlage verwendet werden ===
Variables, die in nur einer Vorlage verwendet werden, müssen mit dem Titel der Vorlage und einem Bindestrich beginnen (z.B. <code>AtkTable-1</code> für [[Vorlage:AtkTable]]). Dies soll Konflikte aufgrund gleicher Variablennamen vermeiden.
Variables, die in nur einer Vorlage verwendet werden, können frei benannt werden. Kurze Namen sind vorzuziehen.
 
Darüber hinaus sollten sie nur dann eingesetzt werden, wenn sie die Performance der Vorlage merklich verbessern oder bei höchstens geringer Verschlechterung der Performance die Lesbarkeit und den Umfang der Vorlage deutlich verbessern. Wird die gleiche Parserkonstruktion nur einige wenige Mal aufgerufen, ist der Einsatz von Variables in der Regel nicht sinnvoll und zu vermeiden.


=== Variables, die in mehreren Vorlagen verwendet werden ===
=== Variables, die in mehreren Vorlagen verwendet werden ===
Variables, die in mehreren Vorlagen verwendet werden, dürfen nur in Absprache mit dem [[PokéWiki:Projekte|Projekt]], zu dem die Vorlage gehört, verwendet werden. Ihr Name ist sinnvoll zu wählen. Alle Variables dieses Typs sind in der Liste am Ende dieser Seite anzugeben, um Konflikte zu vermeiden und ihren Inhalt festzuhalten.
Variables, die in mehreren Vorlagen verwendet werden, dürfen nur in Absprache mit dem [[PokéWiki:Projekte|Projekt]], zu dem die Vorlage gehört, verwendet werden. Ihr Name ist sinnvoll zu wählen. Alle Variables dieses Typs sind in der Liste am Ende dieser Seite anzugeben, um Konflikte zu vermeiden und ihren Inhalt festzuhalten.


Variablen werden in Gruppen abhängig von den Artikeln eingeteilt, in denen sie verwendet werden. Diese stellen zugleich den Beginn des Variablennamens dar. Er ist also nach dem Prinzip ''Gruppe-Titel'' aufgebaut. Pro Artikel sollten also jeweils nur Variablen aus einer Gruppe verwendet werden. Gruppen haben Vorrang vor gleichnamigen Vorlagen, existiert eine gleichnamige Vorlage die Variables benötigt wird ein <code>V:</code> als Präfix ergänzt.
Variablen werden in Gruppen abhängig von den Artikeln eingeteilt, in denen sie verwendet werden. Diese stellen zugleich den Beginn des Variablennamens dar. Er ist also nach dem Prinzip ''Gruppe-Titel'' aufgebaut. Pro Artikel sollten also jeweils nur Variablen aus einer Gruppe verwendet werden.


== Liste ==
== Liste ==
Zeile 78: Zeile 76:
! Typ
! Typ
! Definition in
! Definition in
! Gütligkeit
! Kontext
! Inhalt
! Inhalt
|-
|-
| ep-airjp
| ep-airjp
| Anime-Episoden & Filme
| Anime-Episoden & -Filme
| Konstante
| Konstante
| [[Vorlage:Episode Infobox‎]]<br />[[Vorlage:Infobox Film]]
| [[Vorlage:Episode Infobox|Episode Infobox‎]]<br />[[Vorlage:Infobox Film|Infobox Film]]
| artikelweit
| Seite
| Erstausstrahlung der Episode/des Films in Japan
| Erstausstrahlung der Episode/des Films in Japan
|-
|-
| Pkmn-nr
| Pokémon-Artikel
| Konstante
| [[Vorlage:PokémonPrevNext‎|PokémonPrevNext‎]]<br />[[Vorlage:PokémonInitialiser|PokémonInitialiser]]
| Seite
| Nationaldex-Nummer des Pokémon
|-
| Pkmn-typ1
| Pokémon-Artikel
| Konstante
| [[Vorlage:PokémonPrevNext|PokémonPrevNext‎‎]]<br />[[Vorlage:PokémonInitialiser|PokémonInitialiser]]
| Seite
| Erster Typ des Pokémon
|-
| Pkmn-typ2
| Pokémon-Artikel
| Konstante
| [[Vorlage:PokémonPrevNext|PokémonPrevNext‎‎]]<br />[[Vorlage:PokémonInitialiser|PokémonInitialiser]]
| Seite
| Zweiter Typ des Pokémon wenn vorhanden, sonst erster Typ
|-
| Pkmn-stab1
| Pokémon-Artikel
| Konstante
| [[Vorlage:PokémonPrevNext|PokémonPrevNext‎‎]]<br />[[Vorlage:PokémonInitialiser|PokémonInitialiser]]
| [[Vorlage:AtkTable|AtkTable]]
| Erster STAB des Pokémon
|-
| Pkmn-stab2
| Pokémon-Artikel
| Konstante
| [[Vorlage:PokémonPrevNext‎|PokémonPrevNext‎]]<br />[[Vorlage:PokémonInitialiser|PokémonInitialiser]]
| [[Vorlage:AtkTable|AtkTable]]
| Zweiter STAB des Pokémon
|}
|}


[[Kategorie:PokéWiki:Hilfe]]
[[Kategorie:PokéWiki:Hilfe]]

Version vom 22. Januar 2017, 14:02 Uhr

Hilfeseiten
Allgemein:
Seitengestaltung
Community:
Spezielles:

Die Variables-Extension erlaubt es, Variablen zu definieren und später auf der Seite wieder abzurufen. Dadurch können Vorlagen miteinander kommunizieren und stellenweise deutliche Quelltexteinsparungen geschehen.

Verwendung

Definition

Variablen werden durch die Funktion {{#vardefine:Variablenname|Inhalt}} definiert. Es existiert die alternative #vardefinecho, die den Wert zusätzlich direkt ausgibt.

Beispiele:

Aussehen Quelltext Effekt
{{#vardefine:Hilfe_1|Beispielwert 1}} Der Variable Hilfe_1 wird der Wert Beispielwert 1 zugewiesen.
Beispielwert 1 {{#vardefineecho:Hilfe_1|Beispielwert 1}} Zusätzlich wird der Werte der Variable direkt angezeigt.

Auslesen

Der Wert eine Variable kann durch {{#var:Variablenname|ggf. Standardwert}} abgerufen werden. Entsprechend wird die Funktion vom Parser durch den Wert der Variable substituiert und kann so ausgegeben werden oder an eine Parserfunktion übergeben werden. {{#varexists:Variablenname}} gibt die Möglichkeit zu überprüfen, ob eine Variable definiert wurde.

Beispiele:

Aussehen Quelltext Effekt
Beispielwert 1 {{#var:Hilfe_1}} Der Variable Hilfe_1 wird ausgegeben.
Standard {{#var:Hilfe_2|Standard}} Da die Variable Hilfe_2 nicht definiert ist, wird der Standardwert ausgegeben.
1 {{#varexists:Hilfe_1}} Da die Variable definiert ist, wird 1 ausgegeben.
{{#varexists:Hilfe_2}} Da die Variable nicht definiert ist, wird nichts ausgegeben.

Komplexe Beispiele

# {{#vardefineecho:Hilfe_3|2}}<br />
# {{#varexists:Hilfe_1|{{#vardefine:Hilfe_3|{{#expr:{{#var:Hilfe_3}}+1}}}}
# {{#ifexpr:{{#var:Hilfe_3}} > 2|Yay!|Hä?}}

wird zu:

  1. 2
  2. Yay!

Richtlinien

Da Variables, wenn sie in einer Vorlage verwendet werden, auch die Variables anderer Vorlagen beeinflussen können, gelten gewisse Richtlinien für ihre Verwendung. Diese Regelungen betreffen insbesondere den Artikel- und Vorlagennamensraum, auf Benutzerseiten haben sie keine Gültigkeit.

Variables, die nur in einer Vorlage verwendet werden

Variables, die in nur einer Vorlage verwendet werden, können frei benannt werden. Kurze Namen sind vorzuziehen.

Variables, die in mehreren Vorlagen verwendet werden

Variables, die in mehreren Vorlagen verwendet werden, dürfen nur in Absprache mit dem Projekt, zu dem die Vorlage gehört, verwendet werden. Ihr Name ist sinnvoll zu wählen. Alle Variables dieses Typs sind in der Liste am Ende dieser Seite anzugeben, um Konflikte zu vermeiden und ihren Inhalt festzuhalten.

Variablen werden in Gruppen abhängig von den Artikeln eingeteilt, in denen sie verwendet werden. Diese stellen zugleich den Beginn des Variablennamens dar. Er ist also nach dem Prinzip Gruppe-Titel aufgebaut. Pro Artikel sollten also jeweils nur Variablen aus einer Gruppe verwendet werden.

Liste

Name Seiten Typ Definition in Kontext Inhalt
ep-airjp Anime-Episoden & -Filme Konstante Episode Infobox‎
Infobox Film
Seite Erstausstrahlung der Episode/des Films in Japan
Pkmn-nr Pokémon-Artikel Konstante PokémonPrevNext‎
PokémonInitialiser
Seite Nationaldex-Nummer des Pokémon
Pkmn-typ1 Pokémon-Artikel Konstante PokémonPrevNext‎‎
PokémonInitialiser
Seite Erster Typ des Pokémon
Pkmn-typ2 Pokémon-Artikel Konstante PokémonPrevNext‎‎
PokémonInitialiser
Seite Zweiter Typ des Pokémon wenn vorhanden, sonst erster Typ
Pkmn-stab1 Pokémon-Artikel Konstante PokémonPrevNext‎‎
PokémonInitialiser
AtkTable Erster STAB des Pokémon
Pkmn-stab2 Pokémon-Artikel Konstante PokémonPrevNext‎
PokémonInitialiser
AtkTable Zweiter STAB des Pokémon