Hilfe:Vorlagenmeister

Einer der Erfolge bei der Verbreitung der MediaWiki-Software war es, dass man für die Texteingabe nicht mehr die Auszeichnungssprache des Internets, die HyperText Markup Language (HTML), erlernen musste. Mit leicht zu erlernenden Codes kann man einfache Textauszeichnungen vornehmen. Für schwierigere Fälle stehen so genannte Vorlagen zur Verfügung, die einem viele Formatierungsaufgaben abnehmen. Aber auch Vorlagen können komplex werden. Bis dahin müssen alternative Lösungen herhalten. Diese gibt es zum Beispiel in der Form des Vorlagenmeisters bzw. der semantischen Formulare. Aber auch diese Lösungen sind in der Wikipedia noch nicht verbreitet. Aus Gründen einer einfachen Implementierbarkeit wurde für Wikivoyage der Vorlagenmeister ausgewählt.

Unter welchen Bedingungen einsetzbar?

Browser

Der Vorlagenmeister ist nicht unter allen Browsern einsatzfähig. Er wurde bisher 2009 bzw. 2014 unter Firefox, SeaMonkey, Opera, Internet Explorer, Google Chrome und Midori getestet. In den Browsern Safari, Konqueror und Opera Mini kann er nicht eingesetzt werden. JavaScript muss im Browser für die Domains wikivoyage.org, wikimedia.org und wikipedia.org aktiviert sein.

Benutzeroberfläche

Du musst dich anmelden. Der Vorlagenmeister ist unter der Verwendung der Einstellungen Monobook und Vector einsetzbar. Er kann nicht zusammen mit dem Texteditor wikEd genutzt werden.

Formulare

Für die Formulare werden Definitionsdateien im einem speziellen XML-Format verwendet. Diese gibt es für 59 Vorlagen (Liste der bisher unterstützten Vorlagen). Sollte ein Formular fehlen, so schreibe man seinen Wunsch auf die Vorlagenwerkstatt. Für Vorlagen ohne Parameter wird in der Regel keine Definitionsdatei erstellt.

Aktivieren des Vorlagenmeisters

Der Vorlagenmeister liegt als JavaScript-Programm vor. Er wurde so gestaltet, dass er von der MediaWiki-Software als Gadget (Helferlein) erfasst wird.

Jeder Nutzer kann und muss den Vorlagenmeister selbst aktivieren. Dazu geht man zu den persönlichen Einstellungen. Als sechsten Reiter findet man den der Helferlein. Diesen wählt man aus. In der Liste, unter Bearbeitungswerkzeuge, findet man den Eintrag „Der Vorlagen-Meister erleichtert die Arbeit mit komplexeren Vorlagen. Er erlaubt die komfortable Erzeugung und Änderung von Vorlagen mit bereits definiertem Schema über ein eingeblendetes Eingabeformular“, den man auswählen muss. Anschließend drücke man auf den Schalter „Einstellungen speichern“.

Wenn man nun einen Artikel bearbeitet, so findet man ganz links oberhalb des Bearbeiten-Fensters in der Werkzeugleiste (Toolbar) einen neuen blauen Schalter, den Vorlagenmeister VM oder den Button . (Die Syntaxhervorhebung muss ausgeschaltet sein.)

Verwendung des Vorlagenmeisters

Shortcut:
H:VM

Eine neue Vorlage einfügen

Wenn man eine neue Vorlage einfügen will, so setze man die Schreibmarke an die gewünschte Textstelle. Die Schreibmarke darf sich in diesem Fall nicht innerhalb einer Vorlage befinden.

Nun kann man entsprechend der beiden folgenden Herangehensweisen fortfahren:

Man drückt auf den Schalter „VM“ bzw. „{T}“ in der Werkzeugleiste. Nun erscheint ein kleines Formular, in dem man hinter Vorlage den Namen der gewünschten Vorlage eingeben und bestätigen muss. Dann erscheint das zugehörige Formular, falls es für die Vorlage bereits vorbereitet wurde.
Oder man schreibt eine leere Vorlage mit ihren Namen in den Text: {{Name der Vorlage}}, positioniert die Schreibmarke auf diese Vorlage und drückt dann auf den Schalter „VM“ bzw. „{T}“. Diese Vorgehensweise entspricht streng genommen der Bearbeitung einer bereits bestehenden Vorlage.

Formularbestandteile

Vorlagenmeister mit dem Formular für eine vCard

Ganz oben wird der Name der Vorlage angezeigt. Darunter kann sich eine Leiste mit grauen Schaltern befinden, die der Navigation in gruppierten Formularen dient. Drückt man auf einen derartigen Schalter, so wird die gewählte Gruppe angesprungen.

Darunter befinden sich die eigentlichen Formularfelder. Am Fuße des Formulars findet man rosa unterlegte Hilfeinformationen zum ausgewählten Formularfeld.

Darunter sind die Aktionsschalter „Übernehmen“ und „Abbrechen“ zu finden.

Eine bestehende Vorlage bearbeiten

Um eine vorhandene Vorlage zu bearbeiten, setzt man die Schreibmarke an eine beliebige Stelle zwischen den öffnenden und schließenden Vorlagenklammern und drückt den Schalter „VM“ bzw. „{T}“. Das Programm ermittelt daraufhin, ob für die angegebene Vorlage ein Formular vorbereitet wurde, lädt dieses Formular und befüllt die Eingabefelder mit den Werten aus dem Quelltext.

Fehlerhafte Angaben in einer Vorlage werden unterschiedlich behandelt:

Ein Parameter ist unbekannt. Es erscheint nun eine Leiste mit grünen Schaltern. Es sollte geprüft werden, ob es sich nicht um einen Schreibfehler handelt.
Einem Parameter wurde ein fehlerhafter Wert zugewiesen. Die Formulardefinition enthält eine Liste möglicher Parameterwerte. Ist ein Wert fehlerhaft, so wird kein Wert angezeigt, das Eingabefeld aber rosa unterlegt.

Pflicht- und Wahlangaben

Nicht alle Felder müssen befüllt werden. Die Felder, deren Namen unterstrichen ist, sind Pflichtfelder, die in jedem Fall befüllt werden müssen.

Hilfe

Wenn man ein Formularfeld ausgewählt hat, so erhält man oberhalb der Formularaktionsschalter eine Hilfe zum Eingabeformat. Wenn man mit der Maus auf ein Eingabefeld zeigt, so erscheint ebenfalls eine Hilfe.

Abschluss der Bearbeitungen

Am unteren Ende des Formulars findet man die beiden Aktionsschalter „Übernehmen“ und „Abbrechen“. Im ersten Fall werden die Angaben übernommen, im zweiten Fall verworfen. Nach dem Abschluss findet man sich im gewohnten Wiki-Quelltext wieder.

Probleme mit für Vorlagen reservierten Zeichen

Schwierig wird es, wenn der eingegebene Text Zeichen enthält, die eigentlich der Vorlagenprogrammierung dienen. Hier muss dann das Zeichen ersetzt werden.

Zeichen	`{`	`\|`	`}`	`=`	`[`	`]`	`*`	`#`	`:`	`;`	Leerzeichen	`<`	`>`
Ersetzung	`{`	`\|`	`}`	`=`	`[`	`]`	`*`	`#`	`:`	`;`	` `	`<`	`>`