Wikipedia:Lua/Modul/TemplateData/Global

Statt des üblichen Parameters JSON= wird verwendet:

• Global=Bezeichner

Der Bezeichner identifiziert eine Ressource im globalen Repositorium.

Außerdem kann ein weiterer Parameter für notwendige lokale Anpassungen benutzt werden:

• Local=JSON code

• Es wird das Projekt Commons: (Wikimedia Commons) erwartet, und zwar zurzeit nur im Namensraum Data:.
• Dort wird, sofern dem Bezeichner kein expliziter Pfadname vorangestellt wurde, eine „Oberseite“ Commons:Data:TemplateData angenommen.
• Sofern keine explizite „Datei-Endung“ angehängt wurde, wird das Format .tab angenommen; dies ist „Tabular Data“.

Die Beschreibung description der Gesamt-Tabelle umreißt die vorgesehene Vorlage und verweist auf deren Eintrag bei Wikidata.

Die sonstigen formalen Einträge (Lizenz usw.) entsprechen den üblichen Gepflogenheiten.

Die Daten-Sektion spezifiziert dann vor allem die einzelnen Vorlagenparameter.

Vom Daten-Schema wird erwartet, dass es die meisten der nachstehenden Felder definiert, sofern benötigt:

• aliases wäre eine durch Pipe-Symbole | getrennte Auflistung der Parameternamen.
• deprecated darf (muss), anders als beim MediaWiki TemplateData, vom Typ localized sein.
  deprecated wäre für eine globale Beschreibung einer stabilen Vorlage ungewöhnlich, könnte aber eines Tages ebenfalls auftreten, falls eine Umstellung vorgenommen werden muss.
• autovalue und inherits sowie style werden nicht erwartet, sind jedoch möglich.

Anders als bei dem von MediaWiki für TemplateData vorgesehenen JSON-Objekt, bei dem die Komponenten als set (assoziativ, map) in beliebiger Reihenfolge wiedergegeben werden können, wird hier ein Array von Objekten verwendet. Damit ist sichergestellt, dass die Parameter in genau der definierten Reihenfolge gehandhabt werden.

Allgemein gilt:

• name ist der Name des einzelnen Vorlagenparameters.
• Alle anderen Bezeichner entsprechen den gängigen TemplateData-Attributen.
• Sofern Elemente vom Typ localized oder string für diesen Parameter nicht verwendet werden sollen, kann ihnen der Wert null zugewiesen werden.
• Es müssen immer genauso viele Felder zugewiesen werden wie im Schema definiert wurde, die Aufzählung also ggf. mit null aufgefüllt werden.
• Eine Zeichenkette darf maximal 400 Zeichen lang werden.

Der Parametername |, der in der Vorlagenprogrammierung nicht möglich wäre, hat eine Sonderbedeutung:

• Er definiert die Vorlage als Ganzes.
• Die description ist die Anwenderbeschreibung des Vorlagenzwecks.
• Das Feld type beschreibt das Quelltextformat format (block/inline).

Mit dem Parameter Local= der TemplateData-Vorlage können alle globalen Werte lokal überschrieben werden.

Der Wert ist eine Zeichenkette als JSON im gleichen Format wie der Parameter JSON=, definiert jedoch nur solche Eigenschaften, die sich lokal unterscheiden sollen.

Bei der Parameterliste gibt es folgende Abweichungen:

• Sie ist ein Array von Objekten, genauso wie auch in der globalen Tabelle.
• Sie enthält jedoch nur die Vorlagenparameter.
• Statt als assoziativ benannte Komponente enthält jede Parameterspezifikation einen oder zwei der möglichen string-Werte global und/oder local.

Die Reihenfolge im Array definiert die Reihenfolge in der Darstellung.

Für die Kombination bereits vorhandener Definitionen gilt:

• Ist noch kein Wert gesetzt, wird der lokale Wert verwendet.
• Ist ein atomarer (string/boolean) globaler Wert vorhanden, wird er durch den lokalen Wert überschrieben.
• Ist ein localized bereits vorhanden, sollte der lokale Wert ebenfalls vom Typ localized sein. Vorhandene Sprachkomponenten werden dann mit lokalen Werten überschrieben, zusätzliche Sprachkomponenten hinzugefügt.

• Modul:TemplateData/global

en:User:Yurik