Quelltext der Seite Hilfe:TemplateData/Anwendung

{{Hilfe}}
Dieses Hilfeseite erläutert Wikipedia-Autoren die Bedeutung von Datentypen und Wertformatierungen, die in den Dokumentationsseiten zu [[Hilfe:Vorlagen|Vorlagen]] erwähnt werden, insbesondere wenn dabei '''[[Hilfe:TemplateData|TemplateData]]''' verwendet wird. Die '''Anwendung''' einer bestimmten Vorlageneinbindung soll dadurch erleichtert werden.

Zu allgemeinen Problemen bei der Benutzung von Vorlagen werden [[Hilfe:Vorlagen#Probleme|hier]] Abhilfen angeboten.

== {{Anker|Datentypen}} Datentypen einzelner Parameter ==

=== {{Anker|user}} {{#invoke:Multilingual|int|templatedata-doc-param-type-wiki-user-name|de}} ===
Der Nickname eines registrierten Benutzers ''ohne'' vorangestelltes <code>Benutzer:</code>.

Gelegentlich käme auch die IP-Adresse nicht angemeldeter Benutzer in Frage.

=== {{Anker|boolean}} {{#invoke:Multilingual|int|templatedata-doc-param-type-boolean|de}} ===
Ein Parameterwert, der nur die Bedeutungen „ja“ oder „nein“ haben soll ([[boolesche Logik]]).

Das Format, das Vorlagen erwarten und richtig verarbeiten können, kann sehr unterschiedlich sein:
* Herkömmliche Programmierung interpretiert ''jeden'' nicht-leeren Wert als „ja“&nbsp;– also auch <code>nein</code> oder <code>0</code> usw.
* Der [[Hilfe:VisualEditor|VisualEditor]] schreibt und versteht in einer international üblichen Form:
** <code>1</code> – „ja“ (und alle sonstigen Werte)
** <code>0</code> – „nein“
** ''leer'' – jeweiliger Vorgabewert
* Manche Vorlagen erwarten ausdrücklich bestimmte Zeichenketten; verstehen alle anderen Werte falsch: Es müsse <code>ja</code> oder woanders <code>JA</code> oder bei einer anderen Vorlage <code>Ja</code> oder bei einer weiteren ausdrücklich <code>nein</code> heißen.
* Moderne Vorlagenprogrammierungen sind robust und „verstehen“ unterschiedliche Werte sinngemäß.

=== {{Anker|file}} {{#invoke:Multilingual|int|templatedata-doc-param-type-wiki-file-name|de}} ===
Der Bezeichner einer Mediendatei ''ohne'' vorangestelltes <code>Datei:</code>.

Es  ist unzulässig, hieran Parameter für eine Einbindung anzuhängen (mittels maskierter Pipe-Symbole).

=== {{Anker|date}} {{#invoke:Multilingual|int|templatedata-doc-param-type-date|de}} ===
Ein Datum; möglicherweise ist auch nur eine Jahreszahl oder der Monat in einem Jahr gewünscht, vielleicht aber auch ein bestimmter Tag.

Es gibt unterschiedliche Möglichkeiten, welches Format erwünscht ist und richtig verarbeitet werden kann. Das gewünschte Format sollte immer explizit angegeben sein:
* Standardformate des Projekts:
** <code>{{LOCALDATE}}</code> – ortsübliche Darstellung wie auch für Leser.
** <code>{{#time:Y-m-d}}</code> – [[ISO 8601|ISO-Format]] ''<span style="white-space:nowrap">JJJJ-MM-TT</span>'': Gut sortierbar, mittels [[Hilfe:Suche/Cirrus|Cirrus-Suche]] leicht eingrenzbar, filterbar. International austauschbare Zuweisungen.
* Viele Vorlagenprogrammierungen können mit beiden Eingabeformaten arbeiten, stellen sie für die Leser dann immer als ''<span style="white-space:nowrap">{{LOCALDATE}}</span>'' dar.
** Hier sollte im Zweifelsfall zum ISO-Format übergegangen werden, wenn nichts dagegen spricht, und dies in der Dokumentation auch so angegeben werden.
* Moderne Vorlagenprogrammierungen sind robust und „verstehen“ noch weitere Formate. Trotzdem sollte das angegebene Format benutzt werden, um Auswertungen nicht zu behindern.
* Das Abrufdatum einer Internetressource wird projektweit einheitlich im Format ''<span style="white-space:nowrap">JJJJ-MM-TT</span>'' angegeben, um Auswertungen durch Werkzeuge und Bots unterschiedlicher Herkunft zu unterstützen.

=== {{Anker|wikitext}} {{#invoke:Multilingual|int|templatedata-doc-param-type-content|de}} ===
Beliebiger [[Wikitext]] ist zulässig. Allerdings sollte er eine syntaktische Einheit bilden. Öffnende Elemente (z.&nbsp;B. eckige Klammern) sollen also wieder geschlossen werden.

=== {{Anker|number}} {{#invoke:Multilingual|int|templatedata-doc-param-type-number|de}} (Zahl) ===
Eine Zahl, wobei das Zahlenformat aber von Vorlage zu Vorlage abweichen kann. In Frage kommen:
* <code>12345678,9</code> – ortsübliche Darstellung, jedoch ohne [[Tausendertrennzeichen]], mit Komma&nbsp;<code>,</code> als [[Dezimaltrennzeichen]].
* <code>12345678.9</code> – Computer-geeignetes (internationales) Format, mit Punkt&nbsp;<code>.</code> als Dezimaltrennzeichen, ohne Tausendertrennzeichen, alles [[American Standard Code for Information Interchange|ASCII]], somit auch ein Minuszeichen.
* <code>12.345.678,9</code> – ortsüblich, Tausendertrennzeichen erlaubt.
* <code>5.972E24</code> – [[Exponentialdarstellung]].
* <code>0x07AA</code> – [[Hexadezimalzahl]].
* ''ggf. weitere''
* Ein [[American Standard Code for Information Interchange|ASCII]]-Minuszeichen&nbsp;<code>-</code> („Bindestrich“) ist in der Regel unproblematisch, wenn dies auch inhaltlich sinnvoll ist. Zuweilen wird auch ein typografisches Minuszeichen „–“ akzeptiert.
Das gewünschte Format sollte immer explizit angegeben sein.

Siehe dazu auch: [[Wikipedia:Schreibweise von Zahlen]]

=== {{Anker|page}} {{#invoke:Multilingual|int|templatedata-doc-param-type-wiki-page-name|de}} ===
Der [[Hilfe:Seitenname|Name einer Seite]], womöglich auch in einem anderen Projekt ([[Hilfe:Interwiki-Links|Interwiki]]).

In der Regel wird gewünscht und sinnvoll sein, eine bereits existierende Seite anzugeben; das ist jedoch keine zwingende Voraussetzung.

=== {{Anker|lang}} Sprachen ===
Gelegentlich kommen als Parameter menschliche Sprachen (also keine Programmiersprachen usw.) vor.

Oft werden dabei [[Wikipedia:Technik/MediaWiki/Sprachen|Sprachcodes]] erwartet. Das hat folgende Gründe:
* Sie lassen sich einheitlich auswerten (<code>nl</code> statt: ''holl., holländ., ndl., niederl., niederländ., niederländisch'' usw.).
* Sie können durch Werkzeuge im Klartext ausgewählt und dann kodiert eingefügt werden.
* Manche Angaben werden an externe Software exportiert oder für externe Software verfügbar gemacht (Zitationen, Rechtschreibprogramme, Screenreader)&nbsp;– dafür sind standardisierte Werte erforderlich.
* Einbindungen können international ausgetauscht werden; die Darstellung für Leser erfolgt jeweils in der Sprache der Seite.
* Sie sind kürzer.
Typische Werte wären:
{|
|-
|
* <code>de</code> – {{deS}}
* <code>de-AT</code> – [[{{#language:de-AT}}]]
* <code>de-CH</code> – [[{{#language:de-CH}}]]

|style="padding-left:2em"|
* <code>en</code> – {{enS}}
* <code>fr</code> – {{frS}}
* <code>es</code> – {{esS}}
|}
Theoretisch sind etwa 8500 verschiedene Codes möglich, die von Software verstanden werden könnten. Dabei gehört zu jeder Sprachvariante nur genau ein gültiger Code.
* Zu etwa 700 davon kennt die MediaWiki-Software ihren Namen.
* Zu etwa 250 ist in der deutschsprachigen Wikipedia eine Verlinkung zu einem Artikel über diese Sprache bekannt.

=== {{Anker|url}} {{#invoke:Multilingual|int|templatedata-doc-param-type-url|de}} ===
Eine syntaktisch gültige [[Uniform Resource Locator|URL]] – Leerzeichen können also nicht enthalten sein. Einklammern als Weblink ist hier nicht erlaubt (im Gegensatz zum Daten-Typ „[[#wikitext|{{int:templatedata-doc-param-type-content}}]]“ bzw. „[[#line|Line/Zeile]]“ beispielsweise).

=== {{Anker|template}} {{#invoke:Multilingual|int|templatedata-doc-param-type-wiki-template-name|de}} ===
Der Bezeichner einer [[Hilfe:Vorlagen|Vorlage]] ''ohne'' vorangestelltes <code>Vorlage:</code>.

=== {{Anker|string}} {{#invoke:Multilingual|int|templatedata-doc-param-type-string|de}} ===
Eine längere Zeichenkette. Möglicherweise ist [[Wikitext]]-Formatierung nicht erwünscht; siehe dazu „[[#wikitext|{{int:templatedata-doc-param-type-content}}]]“.

=== {{Anker|line}} {{#invoke:Multilingual|int|templatedata-doc-param-type-line|de}} ===
Ein kurzer Text, etwa ein Bezeichner, ein Code, ein Name, ein Schlagwort.

Wikisyntax kann möglich sein oder auch nicht, je nach Anwendungsfall. In der Regel ist Wikisyntax jedoch eher unerwünscht; wäre das sinvoll, hätte stattdessen „[[#wikitext|{{int:templatedata-doc-param-type-content}}]]“ angegeben werden sollen.

Es wird nur ein einzeiliges Eingabefeld angezeigt, und die Eingabe wird in einer einzigen Zeile in den Quelltext zurückgeschrieben.

Mit dem besonderen Wert <code>-</code> kann bei geeignet programmierten Vorlagen bewirkt werden, dass weder ein speziell gewünschter Freitext noch ein Standardtext für den Fall nicht angegebenen Parameterwerts verwendet wird.

== {{Anker|aliases}} Aliasnamen von Parametern ==
In den Zeilen unter dem vorlagentechnischen Parameternamen in der zweiten Spalte könnten alternative Parameternamen aufgelistet werden.
* Oft handelt es sich um veraltende und deshalb unerwünschte Varianten.
* Damit einheitliche Auswertungen möglich sind, ist oft wünschenswert, dies gelegentlich auf den Standardnamen umzustellen.

== {{Anker|optMand}} Optionale und Pflichtparameter ==
Für die Erfordernis von Parameterangaben gibt es vier Stufen:
# {{Anker|required}} ''{{#invoke:Multilingual|int|templatedata-doc-param-status-required|de}}''
#* Ohne eine Wertangabe ist keine sinnvolle Umsetzung der Vorlageneinbindung möglich.
#* „Pflichtparameter“
#* Fehlende Angaben lösen oft Fehlermeldungen und/oder Wartungskategorien aus.
#* Auch bei fehlender Wertangabe wird in den Quelltext eine leere Wertzuweisung geschrieben.
#* Kennfarbe: hellblau unterlegt.
# {{Anker|suggested}} ''{{#invoke:Multilingual|int|templatedata-doc-param-status-suggested|de}}''
#* Eine Wertangabe ist häufig sinnvoll, aber nicht zwingend erforderlich.
#* Im VisualEditor wird dieses Feld im Menü angeboten.
#* Auch bei fehlender Wertangabe wird in den Quelltext eine leere Wertzuweisung geschrieben, damit dort später leichter ein Wert nachgetragen werden kann.
#* Kennfarbe: weiß unterlegt.
# {{Anker|optional}} ''{{#invoke:Multilingual|int|templatedata-doc-param-status-optional|de}}''
#* Eine Wertangabe ist manchmal notwendig, in der Regel jedoch nicht sinnvoll.
#* Im VisualEditor wird dieses Feld im Menü zunächst nicht angeboten; dieses kann jedoch auf Anforderung erweitert werden.
#* Bei fehlender Wertangabe wird nichts in den Quelltext geschrieben.
#* Kennfarbe: grau unterlegt.
# {{Anker|deprecated}} ''{{#invoke:Multilingual|int|templatedata-doc-param-status-deprecated|de}}''
#* Diese Parameterverwendung sollte im Zuge der Bearbeitung möglichst ersetzt werden.
#* Bei fehlender Wertangabe wird nichts in den Quelltext geschrieben.
#* Kennfarbe: rötlich unterlegt.
  
== {{Anker|autovalue|default|example|Standard|Beispiel|Autowert}} Standardwert und Beispiel ==
Einzelne Parameter können durch standardisierte Zusätze für häufige Situationen genauer erläutert werden.

Wenn eine Vorlage das unterstützt, so wird der unter „{{#invoke:Multilingual|int|templatedata-doc-param-default|de}}“ genannte Ausdruck bei der aktuellen Auswertung verwendet bzw. nach dieser Regel gebildet, falls kein Wert ausdrücklich angegeben ist (also komplett fehlt oder leer ist; auch kein Pflichtparameter vorliegt).

Als „{{#invoke:Multilingual|int|templatedata-doc-param-example|de}}“ kann genau ein konkreter Fall stehen, der die inhaltliche Zielrichtung sowie die konkrete Notation explizit angibt, und nichts anderes.
* Der Wert ist dann nach genau diesem Muster einzutragen.
* Weitere Erklärungen, mehrere Werte sind hier verwirrend und müssen in der allgemeinen Beschreibung dargestellt werden.

Ein „{{#invoke:Multilingual|int|templatedata-doc-param-autovalue|de}}“ könnte theoretisch auftreten.
* Damit würde ein bisher nicht angegebener Wert explizit und dauerhaft belegt werden.
* Es hat sich herausgestellt, dass es hierfür praktisch keine sinnvollen Anwendungen gibt, weil auch später bei nicht angegebenen Werten ein Standardverhalten ausgelöst werden kann.
* Sinnvoll wäre das nur für dynamische Werte, wie etwa das momentane Tagesdatum als Abrufdatum zum Zeitpunkt des Einfügens eines Weblinks. Es sind aber nur konstante, statische Vorgaben möglich, und diese können in den Programmierungen genauso wie fehlende Angaben behandelt werden.

== {{Anker|layout}} Quelltext-Layout ==
Das Quelltext-Format, in dem Skripte die Einbindung schreiben, und das für Benutzer in der Regel auch empfohlen wird, ist zum Schluss der TemplateData-Informationen angegeben.
* ''inline'' – alles auf einer Zeile, ohne Leerzeichen (Standard)
* ''block'' – ein Parameter je Zeile, wie auch bei Infoboxen üblich
* Eine [[Wikipedia:Lua/Modul/TemplateData/Wikitext|Erweiterung in der deutschsprachigen Wikipedia]] ermöglicht weitere menschenfreundlichere Schlüsselwörter.
* Freie Vereinbarung von Leerzeichen und Zeilenumbruch durch spezielle Codes wie <code style="white-space:nowrap"><nowiki>{{_\n| _=_\n}}</nowiki></code>
** Dieser Hinweis ist eher an Vorlagenprogrammierer adressiert.
** Siehe [[../JSON#layout|JSON-Spezifikation]] zu Einzelheiten.
  
== {{Anker|I18N}} Internationalisierung ==
Es wird zunehmend dazu übergegangen, die Werte von Vorlagen zwischen Wikiprojekten austauschbar anzugeben und für vielfältige interne und externe Analyse- und Berechnungswerkzeuge zugänglich zu machen.

Das betrifft dann Werte aus dem Bereich [[#boolean|{{int:templatedata-doc-param-type-boolean}}]], [[#date|{{int:templatedata-doc-param-type-date}}]], [[#number|Nummer (Zahl)]], [[#lang|Sprachen]].
<noinclude>
[[Kategorie:Hilfe:Vorlagen]]
</noinclude>