Module:Dok/doc

Modul für Vorlagendokumentation
Dieser Modul ist zur Verwendung in Vorlagen gedacht und soll die Dokumentation von Vorlagen so weit wie möglich automatisieren.

Innerhalb der Vorlage wird der erzeugende Wikitext angezeigt (mit gewissen Einschränkungen, die in XML-Notation geschriebene Tags und dadurch erzeugte Strip Markers betreffen), sodass man den Inhalt der Vorlage analysieren kann, ohne die Bearbeiten-Seite aufrufen zu müssen.

Die eigentliche Dokumentation wird von einer Unterseite der Vorlage eingebunden, die standardmäßig  genannt wird, dieser Wert kann mit dem Paramter   geändert werden. Wenn ich nachfolgend von der Dokumentationsseite rede, ist diese Unterseite gemeint. Wird keine Dokumentationsseite gewünscht oder gebraucht, kann das Einblenden der Links zu Anlegen der Dokumentationsseite mit der Angabe  unterdrückt werden, es wird dann nur der reine Vorlageninhalt angezeigt.

Die Vorlagendokumentation kommt ohne zusätzliche Vorlagen, Module oder sonstige Wiki-Elemente aus. Einzige Ausnahme sind zwei Icons im PNG-Format, die vorhanden sein sollten: und, wie diese konkrekt aussehen sollen, bleibt dir überlassen.

In die Dokumentationsseite können Anwendungsbeispiele der Vorlage eingebunden werden, die sich beim Ändern der Vorlage automatisch aktualisieren. Auf der Vorlagenseite werden diese Beispiele angezeigt, sodass die Vorlage zugleich die Auswirkungen anzeigt. Ich empfehle, die Vorlage so zu gestalten, dass beim Fehlen von Eingabeparametern eine sinnvolle Ausgabe erzeugt wird.

Die Dokumentationsseite besteht aus mehreren Abschnitten. Zunächst wird die Wirkungsweise der Vorlage erklärt, anschließend wird eine Übersichtstabelle mit den Parametern generiert sowie eine Kopiervorlage mit einer Auflistung aller Parameter. Danach folgen Anwendungsbeispiele, der Wikicode der Vorlage sowie Links zur Vorlagenverwendung und -unterseiten.

Das Anlegen einer Preloadseite für die Dokumentation erleichtert die Erstellung der Dokumentationsseite, ist aber nicht zwingend erforderlich.

Einbindung in die Vorlage

 * Parameterliste

Einbindung in die Dokumentationsunterseite
In die passend benannte Unterseite der Dokumentation (Parameter ) folgenden Code einfügen: &#123;&#123;&#35;invoke:Dok&#124;dokuseite&#125;&#125; &#123;&#123;&#35;invoke:Dok&#124;doku &#125;&#125;
 * text=erzeugt eine sinnvolle Vorlage
 * count=3
 * rubrik=
 * p1=|t1=|d1=|m1=1
 * ... je nachdem wie viele Parameter (count)
 * aw1= ... Anwendungsbeispiel 1
 * aw2= ... Anwendungsbeispiel 2 (derzeit bis zu 10 Stück möglich)
 * ... weitere Parameter lt. Parameterliste
 * Parameterliste

Vorschlag für die Preload-Seite
Der Name der Vorlagenseite (die durch die Vereinfachung per Lua beinahe schon überflüssig geworden ist) für die Dokumentationsunterseite kann per Parameter gewählt werden und lautet standardmäßig Vorlage:Dokumentation/preload-doc. Nachfolgend ein Vorschlag für eine mögliche Vorbelegung. 