Änderungen
Die Seite wurde neu angelegt: „{{Hilfe}} Dieses Element ermöglicht die Generierung von Angaben über [[Hilfe:Vorlagen|Vorlagen]], mit denen sich gültige Einbindungen überprüfen lassen un…“
{{Hilfe}}
Dieses Element ermöglicht die Generierung von Angaben über [[Hilfe:Vorlagen|Vorlagen]], mit denen sich gültige Einbindungen überprüfen lassen und automatische Dokumentationen und Anwendungshinweise erstellt werden können.
== Grundprinzip ==
Die als ''TemplateData'' vereinbarten Informationen über den Zweck der Vorlage und vor allem die detaillierte Beschreibung der Parameter haben zwei Anwendungsbereiche:
* Erstellung einer standardisierten Dokumentationsseite oder eines wesentlichen Teils davon
* Auswertung und automatische Generierung von Eingabeformularen für die Parameter nebst automatisierter Gültigkeitsprüfung der Werte schon bei der Eingabe. Dafür gibt es zurzeit vier Anwendungen:
*# [[Hilfe:VisualEditor|VisualEditor]] – aktueller Anlass für die Entwicklung.
*# [[Wikipedia:Technik/Skin/Gadgets/Vorlagenmeister|Vorlagenmeister]] – früherer Ansatz, über eine [[Extensible Markup Language|XML]]-Spezifikation; mit einem Eingabeformular zum Einfügen in den Quelltext der Wikiseite. Falls keine (detailliertere) XML-Beschreibung für eine bestimmte Vorlage vorhanden ist, wird ersatzweise die TemplateData-Struktur zur Produktion eines Eingabeformulars und zur Gültigkeitsprüfung der Eingabedaten herangezogen.
*# [[Hilfe:Vorlagen/Wizard|Vorlagenassistent]] (Wizard) – Werkzeugleiste WikiEditor „2010“
*# [[Hilfe:VisualEditor/Wikitext#wikitextVE2017|VE-Quelltext]] – Werkzeugleiste „2017“
Das Grundprinzip wurde üblichen [[Software-Dokumentationswerkzeug]]en entnommen; ist etwa an die mit [[javadoc]] zu gewinnenden Informationen angelehnt.
Technisch werden die TemplateData in einem <code><templatedata>...</templatedata></code>-Element kodiert, das unter [[/JSON|JSON]] beschrieben wird. Der Inhalt wird von der Software automatisch in Form einer Tabelle dargestellt, durch die im Prinzip die hergebrachte Parameterdokumentation ersetzt werden kann. Voraussetzung ist die syntaktische und semantische Richtigkeit.
Diese werden mit der Vorlagendefinition in Verbindung gebracht. In der deutschsprachigen Wikipedia sollte dies immer auf der Dokumentationsseite ''/Doku'' geschehen und nicht direkt im Quelltext der Vorlagenprogrammierung.
* In der Versionsgeschichte der eigentlichen Programmierung sollen ausschließlich Änderungen an der wirksamen Programmierung erscheinen, niemals jedoch nachrangige Formulierungsverbesserungen an der Dokumentation; diese gehört deshalb auf die Unterseite /Doku.
Dabei wird das Element <code><templatedata>…</templatedata></code> immer in eine {{Vorlage|TemplateData}} eingeschlossen, die für eine Umrahmung und eine Verlinkung mit dieser Hilfeseite sorgt.
Die Inhalte von TemplateData sind dafür vorgesehen, in universell nutzbarem Format einfache und kurze Texte bereitzustellen; etwa in [[Tooltip]]s oder automatisierten Dokumentationssystemen unabhängig vom Wikiprojekt. Elaborierte und komplexe Darstellungen müssen nach wie vor in gesondertem Wikitext aufbereitet werden.
== {{Anker|MW-Editor}} Formulargestützte Erstellung und Bearbeitung ==
Dieses von MediaWiki bereitgestellte Werkzeug ist nur bei der '''Ersterstellung''' einer TemplateData-Dokumentation verwendbar.
* Es schreibt bevorzugt in die Programmierungsseite.
* In der deutschsprachigen Wikipedia werden aber längere Dokumentationen nicht in die Programmierungsseite geschrieben, sondern in eine gesonderte [[Hilfe:Unterseiten|Unterseite]] <code>/Doku</code>, damit in der [[Hilfe:Versionen|Versionsgeschichte]] nur für die einbindenden Seiten wirksame Veränderungen der Programmierung erscheinen, und nicht jede Schreibfehlerberichtigung der Dokumentation den Neuaufbau von womöglich Tausender einbindender Seiten nach sich zieht.
* Weiterhin wird eine erweiterte Syntax und ein Vorlagenparameter benutzt; deshalb müssen spätere Änderungen in [[/JSON|JSON]] eingepflegt werden; oder aber es wird eine spezielle Vorlagensyntax benutzt: [[Vorlage:TemplateData/JSON]].
=== Schritt 1: Vorlagendokumentations-Editor aufrufen ===
Auf Vorlagen- oder deren Dokumentationsseiten kann das TemplateData-Element automatisch erzeugt werden indem man in den Bearbeitungsmodus geht und dort auf den Knopf <span style="border:1px solid #CDCDCD; color:#555555; display:inline-block; line-height:1.875em; padding:0.2em 0.8em;">'''{{int:templatedata-editbutton}}'''</span> am Seitenkopf klickt. Auf die gleiche Weise können bestehende TemplateData-Elemente nachträglich bearbeitet werden.
'''Wichtig:''' Wenn ein neues TemplateData-Element erstellt werden soll, sollte immer zuerst die Vorlagenseite entsprechend aufgerufen werden, da nur so der nachfolgende Editor alle Parameter der Vorlage automatisch finden und importieren kann. Das wie nachfolgend beschrieben am Ende erzeugte <code style="border:0; background:transparent;">templatedata</code>-Element sollte dann auf die entsprechende Dokumentationsseite kopiert und die Änderungen an der Vorlagenseite verworfen werden.
=== Schritt 2: Parameter automatisch importieren lassen oder manuell hinzufügen ===
<div class="hintergrundfarbe2 float-right" style="border: 1px solid #BBBBBB; border-radius: 3px; font-size: 90%; width: 450px; padding: .2em 0;">
{{Hilfe/dialog|2=p|label-t={{int:templatedata-modal-title}}|label-1=Abbrechen|label-2={{int:templatedata-modal-button-apply}}|noframe=1}}
----
{| class="toptextcells" style="width:100%;"
|-
|style="width:100px;"| {{int:templatedata-modal-title-language}} || <div style="border:1px solid #BBBBBB; line-height:2em; padding:0 1em; width:180px;">[[Datei:OOjs UI icon expand.svg|rechts|verweis=|16px]] Deutsch</div> ||style="float:right;"| {{Hilfe/clickbutton| {{int:templatedata-modal-button-add-language}} }}
|-
|colspan="3"|'''{{int:templatedata-modal-title-templatedesc|de}}'''
|-
|colspan="3"| {{Hilfe/inputarea|placeholder=''Kurzbeschreibung der Vorlage''|rows=2}}
|-
|colspan="3"| '''{{int:templatedata-modal-title-templateformat}}'''
|-
|colspan="3"|<div class="mw-ui-button-group" style="clear:both;"><span class="mw-ui-button" style="background:#1155AA; color:#FFFFFF; padding: 3px;">{{int:templatedata-modal-format-null}}</span><span class="mw-ui-button" style="padding: 3px;">[[Datei:OOjs UI icon inline.svg|18px|verweis=]] {{int:templatedata-modal-format-inline}}</span><span class="mw-ui-button" style="padding: 3px;">[[Datei:OOjs UI icon block-ltr.svg|18px|verweis=]] {{int:templatedata-modal-format-block}}</span><span class="mw-ui-button" style="padding: 3px;">[[Datei:OOjs UI icon advanced.svg|18px|verweis=]] {{int:templatedata-modal-format-custom}}</span></div>
|-
|colspan="3"|{{int:templatedata-modal-title-templateformatstring}}
|-
|colspan="3"|{{Hilfe/inputarea|placeholder={{int:templatedata-modal-format-placeholder}}|typ=i}}
|-
|colspan="3"|'''{{int:templatedata-modal-title-templateparams}}'''
|-
|colspan="3"|
{| style="border:1px solid #BBBBBB;"
|-
| [[Datei:VisualEditor icon parameter-set-ltr.svg|24px]] || '''{{int:templatedata-modal-table-param-importoption|5}}'''<br /><span style="opacity: .6;">{{int:templatedata-modal-table-param-importoption-subtitle|1, 2, …}}</span>
|}
<div style="border: 1px dashed #80D080; margin: .5em; padding: .5em; background:#FFFFFF;">
{| style="width: 100%;"
|-
|style="opacity: .5; width:22px;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''1''' ||style="text-align:right;"| <code>1</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''2''' ||style="text-align:right;"| <code>2</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''Vorname''' ||style="text-align:right;"| <code>Vorname</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''Name''' ||style="text-align:right;"| <code>Name</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''Alter''' ||style="text-align:right;"| <code>Alter</code>
|}
</div>
|}
{{Hilfe/dialog|3=b|label-3=Parameter hinzufügen |line=1|noframe=1}}
</div>
Nach dem Klick auf den Knopf erscheint der rechts abgebildete '''Vorlagendokumentations-Editor''', der im Abschnitt '''Vorlagenparameter''' die gefundenen Parameter auflistet, die mit einem Klick auf '''vorgeschlagene Parameter hinzufügen''' importiert werden können, die dann alle wie rechts beispielhaft abgebildet aufgelistet werden.
Die einzelnen Abschnitte sind:
; Sprache
: Hiermit kann die Dokumentationssprache der Vorlage geändert werden in dem mit einem Klick auf ''Sprache hinzufügen'' eine neue hinzugefügt oder aus dem Auswahlliste eine bestehende ausgewählt werden kann. Generell ist dies jedoch nicht notwendig und sollte auf ''Deutsch'' belassen werden.
; {{int:templatedata-modal-title-templatedesc|de}}
: In diesem Abschnitt sollte eine knappe einzeilige Beschreibung der Vorlage eingegeben werden, die dann im VisualEditor neben dem jeweiligen Vorlagennamen aufgeführt wird.
; {{int:templatedata-modal-title-templateformat}}
: Hier kann festgelegt werden wie die Parameter im Quelltext erscheinen sollen. Mögliche Optionen sind, {{int:templatedata-modal-format-inline}} (hintereinander), {{int:templatedata-modal-format-block}} (untereinander) oder {{int:templatedata-modal-format-custom}} (gemischt).
; Vorlagenparameter
: Dieser wichtigste Abschnitt listet alle gefunden Parameter und deren Kurzbeschreibung auf, soweit vorhanden. Mit einem Klick auf den jeweiligen Parameter können bzw. bei einem neuen TemplateData-Element müssen hier die Zusatzinformationen (Metadaten) der Parameter hinzugefügt werden. Dabei erscheint ein weiteres Formular wie nachfolgend abgebildet.
; Parameterreihenfolge
: Hier werden alle gefundenen Parameter aufgeführt und deren Reihenfolge ausgegeben. Bei einem Parameterimport kann die Reihenfolge eventuell durcheinander geraten sein und nun mittels [[Drag and Drop]] korrigiert werden. Die Reihenfolge beeinflusst dabei nicht nur die Auflistung der Parameter im Vorlagen-Formular des VisualEditors, sondern wie es in den endgültigen Quelltext geschrieben wird. Die Reihenfolge der Parameter sollte daher stets mit der von evtl. Beispielen, Kopierschnipseln usw. der jeweiligen Vorlagendokumentation übereinstimmen.
; Parameter hinzufügen
: Am Ende des Formulars befindet sich ein weiter Knopf mit weitere Parameter hinzugefügt werden können, falls der automatische Import diese übersehen hat oder die Vorlage nachträglich um weitere Parameter ergänzt wurde.
; Anwenden
: Änderungen übernehmen und TemplateData-Element ausgeben.
{{Absatz}}
=== Schritt 3: Parameter beschreiben ===
<div class="hintergrundfarbe2 float-right" style="border: 1px solid #BBBBBB; border-radius: 3px; font-size: 90%; width: 450px; padding: .2em 0;">
{{Hilfe/dialog|2=p|label-t=<div style="padding-left:5em;">'''{{int:templatedata-modal-title}}'''</div>|label-1=|label-2={{int:templatedata-modal-button-done}}|noframe=1}}
----
{| class="toptextcells" style="width:100%;"
|-
|style="width:190px;"| {{int:templatedata-modal-table-param-name}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-aliases}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-label|de}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-description|de}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-example|de}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-type}} || {{Hilfe/inputarea |content= {{int:templatedata-doc-param-type-unknown}}|counter=[[Datei:OOjs UI icon expand.svg|16px|verweis=]]}}
|-
| {{int:templatedata-modal-table-param-suggestedvalues}} || {{Hilfe/inputarea|placeholder=|Wert hinzufügen |remove=Buch |typ=p}}
|-
| {{int:templatedata-modal-table-param-default|de}} || {{Hilfe/inputarea|rows=2}}
|-
| {{int:templatedata-modal-table-param-autovalue}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-deprecated}} || {{Hilfe/ticbox|OOJS=1|tic=0}}
|-
| {{int:templatedata-modal-table-param-required}} || {{Hilfe/ticbox|OOJS=1|tic=0}}
|-
| {{int:templatedata-modal-table-param-suggested}} || {{Hilfe/ticbox|OOJS=1|tic=0}}
|}
{{Hilfe/dialog|3=l|label-3={{int:templatedata-modal-button-delparam}} |line=1|noframe=1}}
</div>
Das Vorlagenparameter-Formular besitzt folgende Felder, wenn man einen der Parameter anklickt:
; Name
: Bezeichnet den primären Namen des Parameters, d. h. denjenigen der am Ende ausgegeben werden soll. Unbenannte Parameter bekommen eine Nummer, die deren Position in der Vorlage angibt.
; Aliasse
: Listet die alternativen Namen des Parameters auf, wobei die einzelnen Einträge durch Kommas getrennt werden müssen. '''Hinweis:''' Wenn die Parameter automatisch importiert wurden, werden für alternative Namen im vorigen Formular ebenfalls Einträge angelegt, da die Importmechanismus nicht erkennen kann, ob ein Parametername eine Alternativbezeichnung oder ein eigenständiger Parameter ist. Diese falschen Parametereinträge müssen in diesem Formular mit einem Klick auf den Knopf ''Parameterinformationen entfernen'' am Formularende gelöscht werden und deren Namen im Aliasse-Feld des korrekten Parametereintrags eingetragen werden.
; Bezeichnung
: Falls von dem Parameternamen nicht automatisch auf die Funktion geschlossen werden kann, kann hier eine verständlichere Bezeichnung angegeben werden, die im VisualEditor verwendet werden soll.
; Beschreibung: Eine Beschreibung der Funktion des Parameters. ''Hinweis:'' Die Beschreibung unterstützt keine Wikitext-Sprachelemente wie Links, Formatierungen, usw., so dass auf diese verzichtet werden muss.
; Beispiel
: In diesem Feld kann ein Beispielwert angegeben werden, der im VisualEditor bei noch leeren Parametern anfangs angezeigt wird, damit der Vorlagennutzer erkennen kann, wie ein gültiger Eintrag aussehen muss.
; Typ
: Hier kann der Datentyp des Parameters angegeben werden, d. h. welche Werte der Parameter akzeptiert. Dabei kann nach folgende Checkliste vorgegangen werden, d. h. der Parameter erlaubt:
:# Wikitext, z. B. Wikilinks, Formatierungen → <code>Inhalt</code>
:# nur Name einer Medien- bzw. Bilddatei ohne Präfix (z. B. Datei:, Bild:, …) → Datentyp <code>Datei</code>
:# nur Benutzername → <code>Benutzer</code>
:# nur Artikel- oder sonstiger Seitenname → <code>Seite</code>
:# nur Zahl, idealerweise ohne Tausendertrennzeichen und mit Punkt . als Dezimaltrenner → <code>Nummer</code>
:# nur Datum nach [[ISO 8601]], d. h. üblicherweise JJJJ-MM-TT → <code>Datum</code>
:# nur Vorlagenname → <code>Vorlage</code>
:# nur Wahrheitswert mit <code>0</code> = Nein und <code>1</code> = Ja → <code>Boolesch</code>
:# akzeptiert nicht wohlgeformten Wikitext, z. B. schließendes Tag ohne öffnendes Tag und umgekehrt → <code>Unausgeglichener Wikitext</code><!-- passt so nicht, dafür werden Klammerfehler […]] oder {{…} … erkannt und in nowiki gesetzt-->
:# sonstiger einzeiliger Text → <code>Zeile</code>
:# sonstiger mehrzeiliger Text → <code>Zeichenfolge</code>
:# unbekannt → <code>Nicht definiert</code>
; Vorgeschlagene Werte
: Für einen Parameter können gültige Werte vorgegeben werden, die aus einer Vorschlagsliste ausgewählt werden können. Werte können einzeln hinzugefügt oder wieder gelöscht werden.
: Beispielanzeige: [[Hilfe:Vorlagen/VisualEditor#Parameter mit Vorschlagsliste|Vorschlagsliste]]
; Standard
: Hier kann angegeben werden, welcher Wert von der Vorlage implizit angenommen wird, wenn der Parameter nicht ausgefüllt wird. Beispielsweise nutzen viele Infobox-Vorlagen den Seitentitel als Überschrift oder verwenden für Bilder eigene Bildgrößen (z. B. 200px) und besitzen einen Extra-Parameter mit dem dieses Verhalten überschrieben werden kann. In diesen Fällen kann dann bei diesen Parametern hier "Seitentitel" oder "200px" angegeben werden.
; Autowert
: Hier kann angegeben werden mit welchem Wert ein noch leerer Vorlagenparameter vorausgefüllt werden soll, der dann auch im Quelltext abgespeichert wird.
; Veraltet
: [[Hilfe:TemplateData/JSON#Status-Parameter|Status-Parameter]], gibt an, ob der Parameter veraltet ist. Wenn ein Parameter als veraltet markiert wurde, dann erscheint ein zusätzliches Eingabefeld in dem ein kurzer Hinweis angegeben werden sollte, wie weiter verfahren werden soll, z. B. welcher Parameter statt dessen genutzt werden sollte.
; Erforderlich
: [[Hilfe:TemplateData/JSON#Status-Parameter|Status-Parameter]], gibt an ob der Parameter unbedingt notwendig ist, damit die Vorlage ordnungsgemäß funktioniert.
; Vorgeschlagen
: [[Hilfe:TemplateData/JSON#Status-Parameter|Status-Parameter]], Vorgeschlagene Parameter sind solche, deren Nutzung empfohlen wird, d. h. jene die am häufigsten verwendet werden. Diese werden im VisualEditor immer angezeigt und müssen nicht erst ergänzt werden und werden am Ende auch immer im Quelltext ausgegeben, selbst wenn sie nicht ausgefüllt wurden.
; Parameterinformationen entfernen
: Hiermit kann der Parameter gelöscht werden. Dies sollte nur gemacht werden, wenn der Parameter entweder aus der Vorlage vollständig entfernt wurde oder ein Alternativname eines bestehenden Parameters ist. Parameter die nicht mehr verwendet werden sollten und nur aus Kompatibilitätsgründen noch von der Vorlage unterstützt werden, sollten statt dessen als ''Veraltet'' markiert werden.
; Fertig
: Änderungen übernehmen und zur Parameterübersicht zurückkehren.
=== Schritt 4: Änderungen übernehmen ===
Nachdem alle Parameter beschrieben wurden, kann im Hauptformular auf ''Anwenden'' geklickt werden, woraufhin das TemplateData-Element erstellt wird. Falls die Vorlage eine Dokumentationsseite besitzt und man wie Eingangs beschrieben das TemplateData-Element auf der Vorlagenseite erzeugt hat, bitte das Element auf die Dokumentationseite kopieren und die Änderungen an der Vorlagenseite verwerfen.
Nach einer inhaltlichen Änderung der Informationen kann man optional einen [[Hilfe:Cache#Nulledit|Null-Edit]] auf der Vorlagenseite tätigen, damit auch diese im Cache umgehend aktualisiert wird und die Metadaten baldmöglichst allen Werkzeugen zur Verfügung stehen.
== {{Anker|JSON-Struktur}} Struktur des TemplateData-Objekts ==
Siehe dazu [[Hilfe:TemplateData/JSON]].
== Hilfsmittel und Hilfen ==
Die Verwendung von <code>TemplateData</code> in dieser Wikipedia wird protokolliert unter:
* [[Special:PagesWithProp/templatedata]]
* [[:Kategorie:Vorlage:mit TemplateData]] – Besser lesbar, navigierbar und würde keine Weiterleitungen aufzählen.
** Die Kategorisierung zählt nur Verwendungen auf, die in {{Vorlage|TemplateData}} eingeschlossen sind. Die Aufzählung der Seiten mit der ''templatedata''-Eigenschaft auf der Spezialseite muss identisch sein mit den Seiten in der Kategorie.
=== Generatoren ===
Alternativ zum [[#MW-Editor|eingebauten Vorlagendokumentations-Editor]]:
* liefert das [[Wikipedia:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] [[Benutzer:PerfektesChaos/js/jsonXMLutils|jsonXMLutils]] aus der Vorlagenprogrammierung oder aber der Kopiervorlage einer älteren Dokumentation oder dem Quelltext einer beliebigen Einbindung ein Grundgerüst.
** Nebenbei formatiert es auch den JSON-Code und analysiert ihn auf bestimmte mutmaßliche inhaltliche Fehler.
** Eine XML-Struktur für den [[Wikipedia:Technik/Skin/Gadgets/Vorlagenmeister|Vorlagenmeister]] kann aus jeder mit TemplateData ausgestatteten Vorlagendokumentation generiert werden.
* kann mit dem vorübergehendem Einfügen von <code><nowiki>{{</nowiki>subst:[[Vorlage:TemplateDataGenerator|TemplateDataGenerator]]}}</code> in die Dokumentationsseite ebenfalls ein Grundgerüst generiert werden.
* gibt es ein [[Wikipedia:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] in der französisch- und englischsprachigen Wikipedia mit einem alternativen Dialogmenü: [[:fr:User:Ltrlg/scripts/TemplateDataEditor.js]] bzw. [[:en:User:NicoV/TemplateDataEditor]]. Dieses befindet sich jedoch auf einem älteren Stand und unterstützt daher nicht alle Datentypen oder den „Vorgeschlagen“-Parameter (''suggested''), dafür aber den ''deprecated''- und den ''inherited''-Parameter.
Bei anhaltenden Problemen hilft die [[Wikipedia:Technik/Werkstatt|Technik-Werkstatt]] weiter.
== Internationalisierung ==
Für Vorlagen, die projektweit verwendet werden, kann das TemplateData-Objekt als Commons-Datensatz unter <code style="border:none;">Data:Templatedata/<Vorlagenname>.tab</code> (ohne die spitzen Klammern) abgelegt werden und dann wie folgt in die jeweiligen Sprachversionen eingebunden werden:
<pre>
{{#invoke:TNT|doc|Vorlagenname}}
</pre>
Dabei wird automatisch die passende Übersetzung ausgegeben. Noch nicht in eine Sprache übersetzte Vorlagen können entsprechend auch auf Commons bearbeitet werden.
So liegt die Dokumentation für {{Vorlage|Graph:Lines}} unter [[commons:Data:Templatedata/Graph:Lines.tab]] in verschiedenen Sprachen vor und wird über <code><nowiki>{{#invoke:TNT|doc|Graph:Lines}}</nowiki></code> hier eingebunden.
Genauso verfährt aber auch die hier verwendete [[Vorlage:TemplateData]] – darüber können ebenfalls global geteilte vielsprachige Definitionen weltweit zentral vorgehalten werden. Die Dokumentation zur [[Vorlage:Interwiki redirect]] stammt aus [[commons:Data:TemplateData/Soft redirect.tab]] und würde auch bei uns [{{fullurl:Vorlage:Interwiki redirect|uselang=it}} auf italienisch] angezeigt – wozu TNT nicht in der Lage ist.
== Sonstiges ==
Die TemplateData-Verwendung wurde im Frühsommer 2013 weltweit gestartet.
Zu technischen Details für Programmierer siehe [[Hilfe:TemplateData/JSON #Sonstiges]].
Wenn du Wünsche hast, dann kannst du es über [[Wikipedia:Technik/Phabricator|Phabricator]] mitteilen oder [[Wikipedia:Technik/Text/Edit/VisualEditor/Rückmeldungen|mitteilen lassen]]. Das gleiche gilt für Bugmeldungen.
== Weitere Informationen ==
{{MediaWiki|Extension:TemplateData|Technische Dokumentation (englisch)}}
* [[Hilfe:TemplateData/VisualEditor]] – Beschreibung des Zusammenspiels der Parametrisierung im TemplateData mit der Auswirkung auf die Ausgabe und Bearbeitungsfunktionen im VisualEditor.
* [[Vorlage:TemplateData]] – Kennzeichnung generierter Dokumentationsblöcke
{{Phabricator|Engage=templatedata|ICON=1|SUFFIX=Status mit Liste bekannter Bugs und Anfragen zur Funktionalitätserweitung|ENGL=1}}
<noinclude>
[[Kategorie:Vorlage:mit TemplateData|!]]
[[Kategorie:Hilfe:Vorlagen]]
[[Kategorie:Hilfe:Wikisyntax]]
[[Kategorie:Hilfe:MediaWiki-Erweiterung]]
</noinclude>
Dieses Element ermöglicht die Generierung von Angaben über [[Hilfe:Vorlagen|Vorlagen]], mit denen sich gültige Einbindungen überprüfen lassen und automatische Dokumentationen und Anwendungshinweise erstellt werden können.
== Grundprinzip ==
Die als ''TemplateData'' vereinbarten Informationen über den Zweck der Vorlage und vor allem die detaillierte Beschreibung der Parameter haben zwei Anwendungsbereiche:
* Erstellung einer standardisierten Dokumentationsseite oder eines wesentlichen Teils davon
* Auswertung und automatische Generierung von Eingabeformularen für die Parameter nebst automatisierter Gültigkeitsprüfung der Werte schon bei der Eingabe. Dafür gibt es zurzeit vier Anwendungen:
*# [[Hilfe:VisualEditor|VisualEditor]] – aktueller Anlass für die Entwicklung.
*# [[Wikipedia:Technik/Skin/Gadgets/Vorlagenmeister|Vorlagenmeister]] – früherer Ansatz, über eine [[Extensible Markup Language|XML]]-Spezifikation; mit einem Eingabeformular zum Einfügen in den Quelltext der Wikiseite. Falls keine (detailliertere) XML-Beschreibung für eine bestimmte Vorlage vorhanden ist, wird ersatzweise die TemplateData-Struktur zur Produktion eines Eingabeformulars und zur Gültigkeitsprüfung der Eingabedaten herangezogen.
*# [[Hilfe:Vorlagen/Wizard|Vorlagenassistent]] (Wizard) – Werkzeugleiste WikiEditor „2010“
*# [[Hilfe:VisualEditor/Wikitext#wikitextVE2017|VE-Quelltext]] – Werkzeugleiste „2017“
Das Grundprinzip wurde üblichen [[Software-Dokumentationswerkzeug]]en entnommen; ist etwa an die mit [[javadoc]] zu gewinnenden Informationen angelehnt.
Technisch werden die TemplateData in einem <code><templatedata>...</templatedata></code>-Element kodiert, das unter [[/JSON|JSON]] beschrieben wird. Der Inhalt wird von der Software automatisch in Form einer Tabelle dargestellt, durch die im Prinzip die hergebrachte Parameterdokumentation ersetzt werden kann. Voraussetzung ist die syntaktische und semantische Richtigkeit.
Diese werden mit der Vorlagendefinition in Verbindung gebracht. In der deutschsprachigen Wikipedia sollte dies immer auf der Dokumentationsseite ''/Doku'' geschehen und nicht direkt im Quelltext der Vorlagenprogrammierung.
* In der Versionsgeschichte der eigentlichen Programmierung sollen ausschließlich Änderungen an der wirksamen Programmierung erscheinen, niemals jedoch nachrangige Formulierungsverbesserungen an der Dokumentation; diese gehört deshalb auf die Unterseite /Doku.
Dabei wird das Element <code><templatedata>…</templatedata></code> immer in eine {{Vorlage|TemplateData}} eingeschlossen, die für eine Umrahmung und eine Verlinkung mit dieser Hilfeseite sorgt.
Die Inhalte von TemplateData sind dafür vorgesehen, in universell nutzbarem Format einfache und kurze Texte bereitzustellen; etwa in [[Tooltip]]s oder automatisierten Dokumentationssystemen unabhängig vom Wikiprojekt. Elaborierte und komplexe Darstellungen müssen nach wie vor in gesondertem Wikitext aufbereitet werden.
== {{Anker|MW-Editor}} Formulargestützte Erstellung und Bearbeitung ==
Dieses von MediaWiki bereitgestellte Werkzeug ist nur bei der '''Ersterstellung''' einer TemplateData-Dokumentation verwendbar.
* Es schreibt bevorzugt in die Programmierungsseite.
* In der deutschsprachigen Wikipedia werden aber längere Dokumentationen nicht in die Programmierungsseite geschrieben, sondern in eine gesonderte [[Hilfe:Unterseiten|Unterseite]] <code>/Doku</code>, damit in der [[Hilfe:Versionen|Versionsgeschichte]] nur für die einbindenden Seiten wirksame Veränderungen der Programmierung erscheinen, und nicht jede Schreibfehlerberichtigung der Dokumentation den Neuaufbau von womöglich Tausender einbindender Seiten nach sich zieht.
* Weiterhin wird eine erweiterte Syntax und ein Vorlagenparameter benutzt; deshalb müssen spätere Änderungen in [[/JSON|JSON]] eingepflegt werden; oder aber es wird eine spezielle Vorlagensyntax benutzt: [[Vorlage:TemplateData/JSON]].
=== Schritt 1: Vorlagendokumentations-Editor aufrufen ===
Auf Vorlagen- oder deren Dokumentationsseiten kann das TemplateData-Element automatisch erzeugt werden indem man in den Bearbeitungsmodus geht und dort auf den Knopf <span style="border:1px solid #CDCDCD; color:#555555; display:inline-block; line-height:1.875em; padding:0.2em 0.8em;">'''{{int:templatedata-editbutton}}'''</span> am Seitenkopf klickt. Auf die gleiche Weise können bestehende TemplateData-Elemente nachträglich bearbeitet werden.
'''Wichtig:''' Wenn ein neues TemplateData-Element erstellt werden soll, sollte immer zuerst die Vorlagenseite entsprechend aufgerufen werden, da nur so der nachfolgende Editor alle Parameter der Vorlage automatisch finden und importieren kann. Das wie nachfolgend beschrieben am Ende erzeugte <code style="border:0; background:transparent;">templatedata</code>-Element sollte dann auf die entsprechende Dokumentationsseite kopiert und die Änderungen an der Vorlagenseite verworfen werden.
=== Schritt 2: Parameter automatisch importieren lassen oder manuell hinzufügen ===
<div class="hintergrundfarbe2 float-right" style="border: 1px solid #BBBBBB; border-radius: 3px; font-size: 90%; width: 450px; padding: .2em 0;">
{{Hilfe/dialog|2=p|label-t={{int:templatedata-modal-title}}|label-1=Abbrechen|label-2={{int:templatedata-modal-button-apply}}|noframe=1}}
----
{| class="toptextcells" style="width:100%;"
|-
|style="width:100px;"| {{int:templatedata-modal-title-language}} || <div style="border:1px solid #BBBBBB; line-height:2em; padding:0 1em; width:180px;">[[Datei:OOjs UI icon expand.svg|rechts|verweis=|16px]] Deutsch</div> ||style="float:right;"| {{Hilfe/clickbutton| {{int:templatedata-modal-button-add-language}} }}
|-
|colspan="3"|'''{{int:templatedata-modal-title-templatedesc|de}}'''
|-
|colspan="3"| {{Hilfe/inputarea|placeholder=''Kurzbeschreibung der Vorlage''|rows=2}}
|-
|colspan="3"| '''{{int:templatedata-modal-title-templateformat}}'''
|-
|colspan="3"|<div class="mw-ui-button-group" style="clear:both;"><span class="mw-ui-button" style="background:#1155AA; color:#FFFFFF; padding: 3px;">{{int:templatedata-modal-format-null}}</span><span class="mw-ui-button" style="padding: 3px;">[[Datei:OOjs UI icon inline.svg|18px|verweis=]] {{int:templatedata-modal-format-inline}}</span><span class="mw-ui-button" style="padding: 3px;">[[Datei:OOjs UI icon block-ltr.svg|18px|verweis=]] {{int:templatedata-modal-format-block}}</span><span class="mw-ui-button" style="padding: 3px;">[[Datei:OOjs UI icon advanced.svg|18px|verweis=]] {{int:templatedata-modal-format-custom}}</span></div>
|-
|colspan="3"|{{int:templatedata-modal-title-templateformatstring}}
|-
|colspan="3"|{{Hilfe/inputarea|placeholder={{int:templatedata-modal-format-placeholder}}|typ=i}}
|-
|colspan="3"|'''{{int:templatedata-modal-title-templateparams}}'''
|-
|colspan="3"|
{| style="border:1px solid #BBBBBB;"
|-
| [[Datei:VisualEditor icon parameter-set-ltr.svg|24px]] || '''{{int:templatedata-modal-table-param-importoption|5}}'''<br /><span style="opacity: .6;">{{int:templatedata-modal-table-param-importoption-subtitle|1, 2, …}}</span>
|}
<div style="border: 1px dashed #80D080; margin: .5em; padding: .5em; background:#FFFFFF;">
{| style="width: 100%;"
|-
|style="opacity: .5; width:22px;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''1''' ||style="text-align:right;"| <code>1</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''2''' ||style="text-align:right;"| <code>2</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''Vorname''' ||style="text-align:right;"| <code>Vorname</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''Name''' ||style="text-align:right;"| <code>Name</code>
|-
|style="opacity: .5;"| [[Datei:OOjs UI icon menu.svg|20px|verweis=]] || '''Alter''' ||style="text-align:right;"| <code>Alter</code>
|}
</div>
|}
{{Hilfe/dialog|3=b|label-3=Parameter hinzufügen |line=1|noframe=1}}
</div>
Nach dem Klick auf den Knopf erscheint der rechts abgebildete '''Vorlagendokumentations-Editor''', der im Abschnitt '''Vorlagenparameter''' die gefundenen Parameter auflistet, die mit einem Klick auf '''vorgeschlagene Parameter hinzufügen''' importiert werden können, die dann alle wie rechts beispielhaft abgebildet aufgelistet werden.
Die einzelnen Abschnitte sind:
; Sprache
: Hiermit kann die Dokumentationssprache der Vorlage geändert werden in dem mit einem Klick auf ''Sprache hinzufügen'' eine neue hinzugefügt oder aus dem Auswahlliste eine bestehende ausgewählt werden kann. Generell ist dies jedoch nicht notwendig und sollte auf ''Deutsch'' belassen werden.
; {{int:templatedata-modal-title-templatedesc|de}}
: In diesem Abschnitt sollte eine knappe einzeilige Beschreibung der Vorlage eingegeben werden, die dann im VisualEditor neben dem jeweiligen Vorlagennamen aufgeführt wird.
; {{int:templatedata-modal-title-templateformat}}
: Hier kann festgelegt werden wie die Parameter im Quelltext erscheinen sollen. Mögliche Optionen sind, {{int:templatedata-modal-format-inline}} (hintereinander), {{int:templatedata-modal-format-block}} (untereinander) oder {{int:templatedata-modal-format-custom}} (gemischt).
; Vorlagenparameter
: Dieser wichtigste Abschnitt listet alle gefunden Parameter und deren Kurzbeschreibung auf, soweit vorhanden. Mit einem Klick auf den jeweiligen Parameter können bzw. bei einem neuen TemplateData-Element müssen hier die Zusatzinformationen (Metadaten) der Parameter hinzugefügt werden. Dabei erscheint ein weiteres Formular wie nachfolgend abgebildet.
; Parameterreihenfolge
: Hier werden alle gefundenen Parameter aufgeführt und deren Reihenfolge ausgegeben. Bei einem Parameterimport kann die Reihenfolge eventuell durcheinander geraten sein und nun mittels [[Drag and Drop]] korrigiert werden. Die Reihenfolge beeinflusst dabei nicht nur die Auflistung der Parameter im Vorlagen-Formular des VisualEditors, sondern wie es in den endgültigen Quelltext geschrieben wird. Die Reihenfolge der Parameter sollte daher stets mit der von evtl. Beispielen, Kopierschnipseln usw. der jeweiligen Vorlagendokumentation übereinstimmen.
; Parameter hinzufügen
: Am Ende des Formulars befindet sich ein weiter Knopf mit weitere Parameter hinzugefügt werden können, falls der automatische Import diese übersehen hat oder die Vorlage nachträglich um weitere Parameter ergänzt wurde.
; Anwenden
: Änderungen übernehmen und TemplateData-Element ausgeben.
{{Absatz}}
=== Schritt 3: Parameter beschreiben ===
<div class="hintergrundfarbe2 float-right" style="border: 1px solid #BBBBBB; border-radius: 3px; font-size: 90%; width: 450px; padding: .2em 0;">
{{Hilfe/dialog|2=p|label-t=<div style="padding-left:5em;">'''{{int:templatedata-modal-title}}'''</div>|label-1=|label-2={{int:templatedata-modal-button-done}}|noframe=1}}
----
{| class="toptextcells" style="width:100%;"
|-
|style="width:190px;"| {{int:templatedata-modal-table-param-name}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-aliases}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-label|de}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-description|de}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-example|de}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-type}} || {{Hilfe/inputarea |content= {{int:templatedata-doc-param-type-unknown}}|counter=[[Datei:OOjs UI icon expand.svg|16px|verweis=]]}}
|-
| {{int:templatedata-modal-table-param-suggestedvalues}} || {{Hilfe/inputarea|placeholder=|Wert hinzufügen |remove=Buch |typ=p}}
|-
| {{int:templatedata-modal-table-param-default|de}} || {{Hilfe/inputarea|rows=2}}
|-
| {{int:templatedata-modal-table-param-autovalue}} || {{Hilfe/inputarea}}
|-
| {{int:templatedata-modal-table-param-deprecated}} || {{Hilfe/ticbox|OOJS=1|tic=0}}
|-
| {{int:templatedata-modal-table-param-required}} || {{Hilfe/ticbox|OOJS=1|tic=0}}
|-
| {{int:templatedata-modal-table-param-suggested}} || {{Hilfe/ticbox|OOJS=1|tic=0}}
|}
{{Hilfe/dialog|3=l|label-3={{int:templatedata-modal-button-delparam}} |line=1|noframe=1}}
</div>
Das Vorlagenparameter-Formular besitzt folgende Felder, wenn man einen der Parameter anklickt:
; Name
: Bezeichnet den primären Namen des Parameters, d. h. denjenigen der am Ende ausgegeben werden soll. Unbenannte Parameter bekommen eine Nummer, die deren Position in der Vorlage angibt.
; Aliasse
: Listet die alternativen Namen des Parameters auf, wobei die einzelnen Einträge durch Kommas getrennt werden müssen. '''Hinweis:''' Wenn die Parameter automatisch importiert wurden, werden für alternative Namen im vorigen Formular ebenfalls Einträge angelegt, da die Importmechanismus nicht erkennen kann, ob ein Parametername eine Alternativbezeichnung oder ein eigenständiger Parameter ist. Diese falschen Parametereinträge müssen in diesem Formular mit einem Klick auf den Knopf ''Parameterinformationen entfernen'' am Formularende gelöscht werden und deren Namen im Aliasse-Feld des korrekten Parametereintrags eingetragen werden.
; Bezeichnung
: Falls von dem Parameternamen nicht automatisch auf die Funktion geschlossen werden kann, kann hier eine verständlichere Bezeichnung angegeben werden, die im VisualEditor verwendet werden soll.
; Beschreibung: Eine Beschreibung der Funktion des Parameters. ''Hinweis:'' Die Beschreibung unterstützt keine Wikitext-Sprachelemente wie Links, Formatierungen, usw., so dass auf diese verzichtet werden muss.
; Beispiel
: In diesem Feld kann ein Beispielwert angegeben werden, der im VisualEditor bei noch leeren Parametern anfangs angezeigt wird, damit der Vorlagennutzer erkennen kann, wie ein gültiger Eintrag aussehen muss.
; Typ
: Hier kann der Datentyp des Parameters angegeben werden, d. h. welche Werte der Parameter akzeptiert. Dabei kann nach folgende Checkliste vorgegangen werden, d. h. der Parameter erlaubt:
:# Wikitext, z. B. Wikilinks, Formatierungen → <code>Inhalt</code>
:# nur Name einer Medien- bzw. Bilddatei ohne Präfix (z. B. Datei:, Bild:, …) → Datentyp <code>Datei</code>
:# nur Benutzername → <code>Benutzer</code>
:# nur Artikel- oder sonstiger Seitenname → <code>Seite</code>
:# nur Zahl, idealerweise ohne Tausendertrennzeichen und mit Punkt . als Dezimaltrenner → <code>Nummer</code>
:# nur Datum nach [[ISO 8601]], d. h. üblicherweise JJJJ-MM-TT → <code>Datum</code>
:# nur Vorlagenname → <code>Vorlage</code>
:# nur Wahrheitswert mit <code>0</code> = Nein und <code>1</code> = Ja → <code>Boolesch</code>
:# akzeptiert nicht wohlgeformten Wikitext, z. B. schließendes Tag ohne öffnendes Tag und umgekehrt → <code>Unausgeglichener Wikitext</code><!-- passt so nicht, dafür werden Klammerfehler […]] oder {{…} … erkannt und in nowiki gesetzt-->
:# sonstiger einzeiliger Text → <code>Zeile</code>
:# sonstiger mehrzeiliger Text → <code>Zeichenfolge</code>
:# unbekannt → <code>Nicht definiert</code>
; Vorgeschlagene Werte
: Für einen Parameter können gültige Werte vorgegeben werden, die aus einer Vorschlagsliste ausgewählt werden können. Werte können einzeln hinzugefügt oder wieder gelöscht werden.
: Beispielanzeige: [[Hilfe:Vorlagen/VisualEditor#Parameter mit Vorschlagsliste|Vorschlagsliste]]
; Standard
: Hier kann angegeben werden, welcher Wert von der Vorlage implizit angenommen wird, wenn der Parameter nicht ausgefüllt wird. Beispielsweise nutzen viele Infobox-Vorlagen den Seitentitel als Überschrift oder verwenden für Bilder eigene Bildgrößen (z. B. 200px) und besitzen einen Extra-Parameter mit dem dieses Verhalten überschrieben werden kann. In diesen Fällen kann dann bei diesen Parametern hier "Seitentitel" oder "200px" angegeben werden.
; Autowert
: Hier kann angegeben werden mit welchem Wert ein noch leerer Vorlagenparameter vorausgefüllt werden soll, der dann auch im Quelltext abgespeichert wird.
; Veraltet
: [[Hilfe:TemplateData/JSON#Status-Parameter|Status-Parameter]], gibt an, ob der Parameter veraltet ist. Wenn ein Parameter als veraltet markiert wurde, dann erscheint ein zusätzliches Eingabefeld in dem ein kurzer Hinweis angegeben werden sollte, wie weiter verfahren werden soll, z. B. welcher Parameter statt dessen genutzt werden sollte.
; Erforderlich
: [[Hilfe:TemplateData/JSON#Status-Parameter|Status-Parameter]], gibt an ob der Parameter unbedingt notwendig ist, damit die Vorlage ordnungsgemäß funktioniert.
; Vorgeschlagen
: [[Hilfe:TemplateData/JSON#Status-Parameter|Status-Parameter]], Vorgeschlagene Parameter sind solche, deren Nutzung empfohlen wird, d. h. jene die am häufigsten verwendet werden. Diese werden im VisualEditor immer angezeigt und müssen nicht erst ergänzt werden und werden am Ende auch immer im Quelltext ausgegeben, selbst wenn sie nicht ausgefüllt wurden.
; Parameterinformationen entfernen
: Hiermit kann der Parameter gelöscht werden. Dies sollte nur gemacht werden, wenn der Parameter entweder aus der Vorlage vollständig entfernt wurde oder ein Alternativname eines bestehenden Parameters ist. Parameter die nicht mehr verwendet werden sollten und nur aus Kompatibilitätsgründen noch von der Vorlage unterstützt werden, sollten statt dessen als ''Veraltet'' markiert werden.
; Fertig
: Änderungen übernehmen und zur Parameterübersicht zurückkehren.
=== Schritt 4: Änderungen übernehmen ===
Nachdem alle Parameter beschrieben wurden, kann im Hauptformular auf ''Anwenden'' geklickt werden, woraufhin das TemplateData-Element erstellt wird. Falls die Vorlage eine Dokumentationsseite besitzt und man wie Eingangs beschrieben das TemplateData-Element auf der Vorlagenseite erzeugt hat, bitte das Element auf die Dokumentationseite kopieren und die Änderungen an der Vorlagenseite verwerfen.
Nach einer inhaltlichen Änderung der Informationen kann man optional einen [[Hilfe:Cache#Nulledit|Null-Edit]] auf der Vorlagenseite tätigen, damit auch diese im Cache umgehend aktualisiert wird und die Metadaten baldmöglichst allen Werkzeugen zur Verfügung stehen.
== {{Anker|JSON-Struktur}} Struktur des TemplateData-Objekts ==
Siehe dazu [[Hilfe:TemplateData/JSON]].
== Hilfsmittel und Hilfen ==
Die Verwendung von <code>TemplateData</code> in dieser Wikipedia wird protokolliert unter:
* [[Special:PagesWithProp/templatedata]]
* [[:Kategorie:Vorlage:mit TemplateData]] – Besser lesbar, navigierbar und würde keine Weiterleitungen aufzählen.
** Die Kategorisierung zählt nur Verwendungen auf, die in {{Vorlage|TemplateData}} eingeschlossen sind. Die Aufzählung der Seiten mit der ''templatedata''-Eigenschaft auf der Spezialseite muss identisch sein mit den Seiten in der Kategorie.
=== Generatoren ===
Alternativ zum [[#MW-Editor|eingebauten Vorlagendokumentations-Editor]]:
* liefert das [[Wikipedia:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] [[Benutzer:PerfektesChaos/js/jsonXMLutils|jsonXMLutils]] aus der Vorlagenprogrammierung oder aber der Kopiervorlage einer älteren Dokumentation oder dem Quelltext einer beliebigen Einbindung ein Grundgerüst.
** Nebenbei formatiert es auch den JSON-Code und analysiert ihn auf bestimmte mutmaßliche inhaltliche Fehler.
** Eine XML-Struktur für den [[Wikipedia:Technik/Skin/Gadgets/Vorlagenmeister|Vorlagenmeister]] kann aus jeder mit TemplateData ausgestatteten Vorlagendokumentation generiert werden.
* kann mit dem vorübergehendem Einfügen von <code><nowiki>{{</nowiki>subst:[[Vorlage:TemplateDataGenerator|TemplateDataGenerator]]}}</code> in die Dokumentationsseite ebenfalls ein Grundgerüst generiert werden.
* gibt es ein [[Wikipedia:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] in der französisch- und englischsprachigen Wikipedia mit einem alternativen Dialogmenü: [[:fr:User:Ltrlg/scripts/TemplateDataEditor.js]] bzw. [[:en:User:NicoV/TemplateDataEditor]]. Dieses befindet sich jedoch auf einem älteren Stand und unterstützt daher nicht alle Datentypen oder den „Vorgeschlagen“-Parameter (''suggested''), dafür aber den ''deprecated''- und den ''inherited''-Parameter.
Bei anhaltenden Problemen hilft die [[Wikipedia:Technik/Werkstatt|Technik-Werkstatt]] weiter.
== Internationalisierung ==
Für Vorlagen, die projektweit verwendet werden, kann das TemplateData-Objekt als Commons-Datensatz unter <code style="border:none;">Data:Templatedata/<Vorlagenname>.tab</code> (ohne die spitzen Klammern) abgelegt werden und dann wie folgt in die jeweiligen Sprachversionen eingebunden werden:
<pre>
{{#invoke:TNT|doc|Vorlagenname}}
</pre>
Dabei wird automatisch die passende Übersetzung ausgegeben. Noch nicht in eine Sprache übersetzte Vorlagen können entsprechend auch auf Commons bearbeitet werden.
So liegt die Dokumentation für {{Vorlage|Graph:Lines}} unter [[commons:Data:Templatedata/Graph:Lines.tab]] in verschiedenen Sprachen vor und wird über <code><nowiki>{{#invoke:TNT|doc|Graph:Lines}}</nowiki></code> hier eingebunden.
Genauso verfährt aber auch die hier verwendete [[Vorlage:TemplateData]] – darüber können ebenfalls global geteilte vielsprachige Definitionen weltweit zentral vorgehalten werden. Die Dokumentation zur [[Vorlage:Interwiki redirect]] stammt aus [[commons:Data:TemplateData/Soft redirect.tab]] und würde auch bei uns [{{fullurl:Vorlage:Interwiki redirect|uselang=it}} auf italienisch] angezeigt – wozu TNT nicht in der Lage ist.
== Sonstiges ==
Die TemplateData-Verwendung wurde im Frühsommer 2013 weltweit gestartet.
Zu technischen Details für Programmierer siehe [[Hilfe:TemplateData/JSON #Sonstiges]].
Wenn du Wünsche hast, dann kannst du es über [[Wikipedia:Technik/Phabricator|Phabricator]] mitteilen oder [[Wikipedia:Technik/Text/Edit/VisualEditor/Rückmeldungen|mitteilen lassen]]. Das gleiche gilt für Bugmeldungen.
== Weitere Informationen ==
{{MediaWiki|Extension:TemplateData|Technische Dokumentation (englisch)}}
* [[Hilfe:TemplateData/VisualEditor]] – Beschreibung des Zusammenspiels der Parametrisierung im TemplateData mit der Auswirkung auf die Ausgabe und Bearbeitungsfunktionen im VisualEditor.
* [[Vorlage:TemplateData]] – Kennzeichnung generierter Dokumentationsblöcke
{{Phabricator|Engage=templatedata|ICON=1|SUFFIX=Status mit Liste bekannter Bugs und Anfragen zur Funktionalitätserweitung|ENGL=1}}
<noinclude>
[[Kategorie:Vorlage:mit TemplateData|!]]
[[Kategorie:Hilfe:Vorlagen]]
[[Kategorie:Hilfe:Wikisyntax]]
[[Kategorie:Hilfe:MediaWiki-Erweiterung]]
</noinclude>
