Zum Inhalt springen

Vorlage:TemplateData/Doku

Aus Wikibooks

Verwendung

[Bearbeiten]

Mit dieser Vorlage können auf der Dokumentationsseite einer Vorlage ihre Parameter mit Hilfe der Parser-Extension <templatedata> spezifiziert werden. Diese maschinenlesbare Spezifikation wird beispielsweise vom Tool VisualEditor verwendet und hat den positiven Nebeneffekt, dass die Vorlagenparameter dokumentiert werden.

Syntax

[Bearbeiten]

Allgemein kann folgender Quellcode am Ende der Dokumentationsseite eingebunden werden:

{{TemplateData
 |beschreibung=<Beschreibungstext>
 |parameter=<Spezifikation der Parameter (optional)>
 |parameter-sets=<Spezifikation der Parameter sets (optional)>
}}

Beispielsweise ist für diese Dokumentation am Ende der Seite folgender Code eingebunden:

{{TemplateData
 |beschreibung=Vorlage, um eine Vorlagen-Spezifikation am Ende der Seite einzubinden
 |parameter=
    "beschreibung": {"label": "Beschreibung", "description": "Der Beschreibungstext", "required": true, "type": "line", "example": "Vorlage, um ein zufälliges Bild aus einer Liste einzublenden"},
    "parameter": {"label": "Parameter", "description": "Die Parameter der Vorlage", "type": "string", "default": "keine Parameter", "suggested": true, "example": "\"1\": {\"label\": \"Bilderliste\", \"description\": \"Liste der Bilder, Trennzeichen „;“\", \"type\": \"line\", \"required\": \"true\"}"},
    "parameter-sets": {"label": "Parameter-Sets", "description": "Parameter-Sets", "type": "string", "default": "leere Liste"}
}}

Die Parameter

[Bearbeiten]

Der Parameter beschreibung

[Bearbeiten]

Dieser Parameter ist notwendig und soll eine kurze Beschreibung der Vorlage enthalten. Dieser Parameter entspricht den description-Parameter für eine Vorlage von <templatedata>.

Der Parameter parameter

[Bearbeiten]

Dieser Parameter entspricht dem Inhalt vom params-Parameter von <templatedata>, wobei die umschließenden geschweiften Klammern nicht mitgeschrieben werden müssen (siehe obiges Beispiel). Dieser Parameter kann für Vorlagen, welche keine Parameter besitzen, weggelassen werden.

Der Parameter parameter-sets

[Bearbeiten]

Dieser Parameter entspricht dem Parameter sets von <templatedata>. Die umschließenden eckigen Klammern der Liste dürfen nicht mitgeschrieben werden. Auch dieser Parameter ist optional.

Vorlagen-Spezifikation

Vorlage, um eine Vorlagen-Spezifikation am Ende der Seite einzubinden

Vorlagenparameter[Vorlagendaten bearbeiten]

ParameterBeschreibungTypStatus
Beschreibungbeschreibung

Der Beschreibungstext

Beispiel
Vorlage, um ein zufälliges Bild aus einer Liste einzublenden
Einzeiliger Texterforderlich
Parameterparameter

Die Parameter der Vorlage

Standard
keine Parameter
Beispiel
"1": {"label": "Bilderliste", "description": "Liste der Bilder, Trennzeichen „;“", "type": "line", "required": "true"}
Mehrzeiliger Textvorgeschlagen
Parameter-Setsparameter-sets

Parameter-Sets

Standard
leere Liste
Mehrzeiliger Textoptional

Hinweis: Diese Vorlagen-Spezifikation wurde mit Hilfe der Parsererweiterung <templatedata> erstellt. Siehe Vorlage:TemplateData für eine Erklärung, wie du <templatedata> auf Wikibooks verwenden kannst.

<templatedata> wird unter anderem vom VisualEditor verwendet. Eine ausführliche Hilfe zu dieser Parsererweiterung findest auf der Seite Help:TemplateData.