Dieses Wiki enthält einerseits Tipps&Tricks zum Thema Lilypond, andererseits Lilypond-Scores.
Elise-rechteHand.png

Vorlage:Vorlagendokumentation

Wechseln zu: Navigation, Suche

Allgemeine Überlegungen[Bearbeiten]

Eine Vorlage wird dann angelegt, wenn immer wiederkehrende Vorgänge im Wiki durchgeführt werden sollen. In einer Vorlage stecken eine Menge Überlegungen, die dazu neigen, nach kurzer Zeit wieder vergessen zu werden. Und dann steht man da und weiß nicht mehr, was man sich eigentlich dabei gedacht hat.

Dies soll durch eine Vorlagendokumentation verhindert werden, die einerseits einfach zu erstellen, andererseits übersichtlich, klar und leicht zu durchschauen ist.

Die Vorlagendokumentation besteht ihrerseits aus einer Reihe von Vorlagen, die in die zu dokumentierende Vorlage eingebunden werden. Hier eine Liste der Unterseiten der Vorlagendokumentation:

Vorlagen, die für die Dokumentation von Vorlagen benötigt werden:

Vorlage Documentation[Bearbeiten]

Das Einbinden der Vorlage {{Documentation}} in eine Vorlage bewirkt, dass die Unterseite

{{SUBJECTPAGENAME}}/doc

eingebunden wird. Diese Unterseite soll eine Beschreibung der Wirkungsweise der Vorlage enthalten, alle verwendeten Parameter auflisten, einige aussagekräftige Anwendungsbeispiele enthalten und den Wikicode der Vorlage anzeigen.

Der Aufbau einer Dokumentationsunterseite soll einem wiederkehrenden Schema folgen, das hier beschrieben wird. Die Unterseite {{Documentation/layout}} enthält einen Link zur Dokumentation {{SUBJECTPAGENAME}}/doc, sodass diese Seite leicht bearbeitet werden kann.

Ist die Unterseite

{{SUBJECTPAGENAME}}/doc

noch nicht vorhanden, wird ein diesbezüglicher Hinweis mit Links eingebunden, die das Anlegen der Dokumentationsseite vereinfachen. Ein Link legt die Dokumentationsunterseite ohne Inhalt an, das ist dann nützlich, wenn man bereits eine kopierfertige Dokumentation hat, aus einem anderen Wiki z.B. oder von einer ähnlichen Vorlage. Der Link mit der Inputbox legt eine Seite mit der Preload-Datei[1]

{{Documentation/preload-doc}} an. Diese habe ich so gestaltet, dass sie möglichst viele Arbeitsschritte abnimmt. Die Struktur ist vordefiniert, eine Tabelle der Parameter enthalten sowie die automatische Anzeige des Wikicodes der Vorlage.

Da die Tabelle einige Formatierungsvorlagen enthält, sind für die vollständige und „schöne“ Anzeige der Dokumentation weitere Vorlagen erforderlich, die dazu dienen, um die Formatierung zu verbessern und die Bearbeitung zu vereinfachen.

Aufbau der Dokumentationsseite {{SUBJECTPAGENAME}}/doc[Bearbeiten]

Vor der Beschreibung[Bearbeiten]

Dieser Teil wird bei Tansclusion nicht in andere Seiten eingebunden und soll die Bearbeitung der Vorlage und ihrer Dokumentation vereinfachen.

{{Cat|Dokumentation}}{{Bearbeiten}}
{{Documentation/Dokuseite}}


  • {{cat|dokumentation}}: Einordnen in die Kategorie Dokumentation
  • {{bearbeiten}} erzeugt ein Kästchen mit Links zum Bearbeiten und Leeren des Caches in der eingebundenen Seite. Außerdem erkennt die Vorlage, ob sie in eine Vorlagendokumentation eingebunden ist. Wenn ja, erzeugt sie zusätzlich Links zum Bearbeiten der Vorlage und Seiteninformation der Vorlage.

Vorlage:Bearbeiten

Information icon.svg Diese Seite ist eine Dokumentations-Unterseite der [[]].

Beschreibung der Wirkungsweise der Vorlage[Bearbeiten]

Dieser Teil wird in die Vorlage eingebunden und enthält eine möglichst einfache und verständliche Beschreibung der Wirkungsweise der Vorlage. Falls die Vorlage Teil einer Anzahl ähnlicher bzw. inhaltlich zusammenhängender Vorlagen ist, soll eine Vorlagenliste eingebunden werden, die Links zu allen vergleichbaren und zusammenhängenden Vorlagen sowie einen Link auf die Liste aller Vorlagenlisten enthält.

Die Vorlagenliste kategorisiert jede einbindende Vorlage automatisch in die betreffende Kategorie ein, dadurch aktualisiert sich die Liste automatisch.

Verwendung[Bearbeiten]

Als erstes werden alle verfügbaren Parameter aufgezählt, das ist zum Kopieren in die Zwischenablage gedacht. Da die Zahl der Parameter immer größer wurde, habe ich mehrere Vorlagenanzeigen entwickelt, die eine unterschiedliche Anzahl von Paramtern darstellen können. Unbenannte Parameter klammere ich mit Angabe der Nummer ein.

Beispiel: {{2x|(1=)|keinParameter=}}

Anschließend folgen einige möglichst aussagekräftige unterschiedliche Anwendungsbeispiele, wobei jedes Beispiel von einer dicken blauen Linie umrahmt wird, um es abzugrenzen. Mittels der Vorlage {{Xpds}}, der den Modul Xpd verwendet, wird der expandierte Wikicode umgeben von gepunkteten Linien angezeigt. Die Wirkungsweise der Vorlage wird nochmals mit einer gepunkteten Linie abgegrenzt.

{{2x|Hauptseite}}

Vorlage:BluexBox

Vorlage:BluexBox

Die Rahmenlinien erzeuge ich mittels der Vorlage {{Div-dotted}} und {{Div-dotted|width=100%|style=solid|cborder=blue}}.

Parameterliste[Bearbeiten]

In Tabellenform eine Liste aller Parameter mit Namen, Beschreibung, Voreinstellung.

Für diese Tabelle habe ich eine neue Vorlage entwickelt, {{PT-tab}}, die das Erstellen und Verwalten der Parametertabelle deutlich vereinfacht und übersichtlicher gestaltet.

Hier ein Beispiel: Vorlage:PT-tab

Wikicode der Vorlage[Bearbeiten]

Als letzter Punkt folgt der Wikicode der Vorlage, wobei die Vorlage {{ShowMe}} verwendet wird. Diese verwendet die Funktion {{msgnw:}}[2], um den Seiteninhalt anzuzeigen. Der Nachteil dieser Funktion ist, dass Überschriften nicht korrekt angezeigt werden. {{ShowMe}} kann auch verwendet werden, um eine „Blitzdokumentation“ des Seiteninhalts ohne Einbindung der Vorlage {{Documentation}} zu erzeugen.

Vorlage Documentation und ihre Unterseiten[Bearbeiten]

Liste per Special:PrefixIndex[Bearbeiten]

Documentation[Bearbeiten]

Die Vorlagendokumentation {{Documentation}} wird direkt in die Vorlage eingebunden und bindet ihrerseits folgende Unterseiten ein:

{{Documentation/ruler}}

{{Documentation/layout}}

enthält bei Einbindung in eine Vorlage einen Link auf diese Seite, damit kann ich die Vorlagendokumentation von jeder Vorlage aus mit einem Mausklick erreichen

Template-info.png Vorlagendokumentation

AnzeigenBearbeitenVersionenCache leeren

{{Documentation/nodoc}} wird dann eingebunden, wenn die Dokumentationsunterseite nicht vorhanden ist.

Du hast die Vorlagendokumentation mit dem Befehl {{documentation}} eingebunden
Die Dokumentationsunterseite Vorlage:Vorlagendokumentation/doc ist nicht vorhanden.

Damit die Dokumentation wie vorgesehen funktioniert, ist es erforderlich, dass du für deine Vorlage {{Vorlage:Vorlagendokumentation}} die Unterseite Vorlage:Vorlagendokumentation/doc anlegst, das kannst du mit der Box unter diesem Text durchführen.

Unterseite Vorlage:Vorlagendokumentation/doc erstellen[Bearbeiten]

Eine Liste der bereits vorhandenen Unterseiten (für den Fall, dass die Dokuseite schon existiert und bloß falsch benannt wurde):

Formatierungs- und Bearbeitungsvorlagen[Bearbeiten]

Wikicode dieser Seite[Bearbeiten]

{{TOC}}

=='"`UNIQ--h-14--QINU`"' Allgemeine Überlegungen == Eine Vorlage wird dann angelegt, wenn immer wiederkehrende Vorgänge im Wiki durchgeführt werden sollen. In einer Vorlage stecken eine Menge Überlegungen, die dazu neigen, nach kurzer Zeit wieder vergessen zu werden. Und dann steht man da und weiß nicht mehr, was man sich eigentlich dabei gedacht hat. Dies soll durch eine Vorlagendokumentation verhindert werden, die einerseits einfach zu erstellen, andererseits übersichtlich, klar und leicht zu durchschauen ist. Die Vorlagendokumentation besteht ihrerseits aus einer Reihe von Vorlagen, die in die zu dokumentierende Vorlage eingebunden werden. Hier eine Liste der Unterseiten der Vorlagendokumentation: {{VListe|VDoc|Vorlagendokumentationsvorlagen|Vorlagen, die für die Dokumentation von Vorlagen benötigt werden|quer=|mode=unordered}} =='"`UNIQ--h-15--QINU`"' Vorlage Documentation == Das Einbinden der Vorlage {{Tl|Documentation}} in eine Vorlage bewirkt, dass die Unterseite {{BlueBox|<nowiki>{{SUBJECTPAGENAME}}/doc</nowiki>}} eingebunden wird. Diese Unterseite soll eine Beschreibung der Wirkungsweise der Vorlage enthalten, alle verwendeten Parameter auflisten, einige aussagekräftige Anwendungsbeispiele enthalten und den Wikicode der Vorlage anzeigen. Der Aufbau einer Dokumentationsunterseite soll einem wiederkehrenden Schema folgen, das hier beschrieben wird. Die Unterseite {{Tl|Documentation/layout}} enthält einen Link zur Dokumentation <code><nowiki>{{SUBJECTPAGENAME}}/doc</nowiki></code>, sodass diese Seite leicht bearbeitet werden kann. Ist die Unterseite {{BlueBox|<nowiki>{{SUBJECTPAGENAME}}/doc</nowiki>}} noch nicht vorhanden, wird ein diesbezüglicher Hinweis mit Links eingebunden, die das Anlegen der Dokumentationsseite vereinfachen. Ein Link legt die Dokumentationsunterseite ohne Inhalt an, das ist dann nützlich, wenn man bereits eine kopierfertige Dokumentation hat, aus einem anderen Wiki z.B. oder von einer ähnlichen Vorlage. Der Link mit der Inputbox legt eine Seite mit der {{Ref|url=https://www.mediawiki.org/wiki/Manual:Creating_pages_with_preloaded_text|utext=Preload-Datei}} {{Tl|Documentation/preload-doc}} an. Diese habe ich so gestaltet, dass sie möglichst viele Arbeitsschritte abnimmt. Die Struktur ist vordefiniert, eine Tabelle der Parameter enthalten sowie die automatische Anzeige des Wikicodes der Vorlage. Da die Tabelle einige Formatierungsvorlagen enthält, sind für die vollständige und „schöne“ Anzeige der Dokumentation weitere Vorlagen erforderlich, die dazu dienen, um die Formatierung zu verbessern und die Bearbeitung zu vereinfachen. =='"`UNIQ--h-16--QINU`"' Aufbau der Dokumentationsseite <code><nowiki>{{SUBJECTPAGENAME}}/doc</nowiki></code> == ==='"`UNIQ--h-17--QINU`"' Vor der Beschreibung === Dieser Teil wird bei Tansclusion nicht in andere Seiten eingebunden und soll die Bearbeitung der Vorlage und ihrer Dokumentation vereinfachen. {{Code|1=<nowiki>{{Cat|Dokumentation}}{{Bearbeiten}} {{Documentation/Dokuseite}}</nowiki>}} *{{Catx|dokumentation}}: Einordnen in die [[:Kategorie:Dokumentation|Kategorie Dokumentation]] *{{Tl|bearbeiten}} erzeugt ein Kästchen mit Links zum Bearbeiten und Leeren des Caches in der eingebundenen Seite. Außerdem erkennt die Vorlage, ob sie in eine Vorlagendokumentation eingebunden ist. Wenn ja, erzeugt sie zusätzlich Links zum Bearbeiten der Vorlage und Seiteninformation der Vorlage. {{bearbeiten}} *{{Tl|Documentation/Dokuseite}} erzeugt folgenden Hinweis {{Documentation/Dokuseite}} ==='"`UNIQ--h-18--QINU`"' Beschreibung der Wirkungsweise der Vorlage === Dieser Teil wird in die Vorlage eingebunden und enthält eine möglichst einfache und verständliche Beschreibung der Wirkungsweise der Vorlage. Falls die Vorlage Teil einer Anzahl ähnlicher bzw. inhaltlich zusammenhängender Vorlagen ist, soll eine Vorlagenliste eingebunden werden, die Links zu allen vergleichbaren und zusammenhängenden Vorlagen sowie einen Link auf die [[Vorlage:AlleListen|Liste aller Vorlagenlisten]] enthält. Die Vorlagenliste kategorisiert jede einbindende Vorlage automatisch in die betreffende Kategorie ein, dadurch aktualisiert sich die Liste automatisch. ==='"`UNIQ--h-19--QINU`"' Verwendung === Als erstes werden alle verfügbaren Parameter aufgezählt, das ist zum Kopieren in die Zwischenablage gedacht. Da die Zahl der Parameter immer größer wurde, habe ich mehrere Vorlagenanzeigen entwickelt, die eine unterschiedliche Anzahl von Paramtern darstellen können. Unbenannte Parameter klammere ich mit Angabe der Nummer ein. Beispiel: {{Tlx|2x|(1&#61;)|keinParameter&#61;}} Anschließend folgen einige möglichst aussagekräftige unterschiedliche Anwendungsbeispiele, wobei jedes Beispiel von einer dicken blauen Linie umrahmt wird, um es abzugrenzen. Mittels der Vorlage {{Tl|Xpds}}, der den Modul [[Module:Xpd|Xpd]] verwendet, wird der expandierte Wikicode umgeben von gepunkteten Linien angezeigt. Die Wirkungsweise der Vorlage wird nochmals mit einer gepunkteten Linie abgegrenzt. {{Div-dotted|width=100%|style=solid|cborder=blue}} {{Tlx|2x|[[Hauptseite]]}} {{BluexBox|ergibt als Wikitext expandiert}} <div style="width:95%;margin-top:1em; border: 2px dotted #666666; padding: 0.6em">{{Xpds|2x|[[Hauptseite]]}}</div> {{BluexBox|gerendert}} {{Div-dotted}} {{2x|[[Hauptseite]]}}</div></div> Die Rahmenlinien erzeuge ich mittels der Vorlage {{Tl|Div-dotted}} und {{Tlx|Div-dotted|width&#61;100%|style&#61;solid|cborder&#61;blue}}. ==='"`UNIQ--h-20--QINU`"' Parameterliste === In Tabellenform eine Liste aller Parameter mit Namen, Beschreibung, Voreinstellung. Für diese Tabelle habe ich eine neue Vorlage entwickelt, {{Tl|PT-tab}}, die das Erstellen und Verwalten der Parametertabelle deutlich vereinfacht und übersichtlicher gestaltet. Hier ein Beispiel: {{PT-tab |p1=1|t1=was tut Parameter 1 |p2=2|t2=was tut Parameter 2|d2=default 2|m2= |p3=3|t3=Parameter 3 erforderlich|d3=|m3=1 |p4=|t4=|d4=|m4= |p5=|t5=|d5=|m5= |p6=|t6=|d6=|m6= |p7=|t7=|d7=|m7= |p8=|t8=|d8=|m8= |p9=|t9=|d9=|m9= |p10=|t10=|d10=|m10= |p11=|t11=|d11=|m11= |p12=|t12=|d12=|m12= |p13=|t13=|d13=|m13= |p14=|t14=|d14=|m14= |p15=|t15=|d15=|m15= |p16=|t16=|d16=|m16= |p17=|t17=|d17=|m17= |p18=|t18=|d18=|m18= |p19=|t19=|d19=|m19= |p20=|t20=|d20=|m20= |p21=|t21=|d21=|m21= |p22=|t22=|d22=|m22= |p23=|t23=|d23=|m23= |p24=|t24=|d24=|m24= }} ==='"`UNIQ--h-21--QINU`"' Wikicode der Vorlage === Als letzter Punkt folgt der Wikicode der Vorlage, wobei die Vorlage {{Tl|ShowMe}} verwendet wird. Diese verwendet die Funktion {{ref|url=https://www.mediawiki.org/wiki/Help:Magic_words/de#Transclusion_modifiers|utext=<code><nowiki>{{msgnw:}}</nowiki></code>}}, um den Seiteninhalt anzuzeigen. Der Nachteil dieser Funktion ist, dass Überschriften nicht korrekt angezeigt werden. {{Tl|ShowMe}} kann auch verwendet werden, um eine „Blitzdokumentation“ des Seiteninhalts ohne Einbindung der Vorlage {{Tl|Documentation}} zu erzeugen. =='"`UNIQ--h-22--QINU`"' Vorlage Documentation und ihre Unterseiten == ==='"`UNIQ--h-23--QINU`"' Liste per Special:PrefixIndex === {{:Special:PrefixIndex/Vorlage:Documentation}} ==='"`UNIQ--h-24--QINU`"' Documentation === Die Vorlagendokumentation {{Tl|Documentation}} wird direkt in die Vorlage eingebunden und bindet ihrerseits folgende Unterseiten ein: {{Div-dotted|width=100%|style=solid|cborder=blue}}{{Tl|Documentation/ruler}} {{Div-dotted}} {{Documentation/ruler}}</div></div> {{Div-dotted|width=100%|style=solid|cborder=blue}}{{Tl|Documentation/layout}} enthält bei Einbindung in eine Vorlage einen Link auf diese Seite, damit kann ich die Vorlagendokumentation von jeder Vorlage aus mit einem Mausklick erreichen {{Div-dotted}} {{Documentation/layout}}</div></div> {{Div-dotted|width=100%|style=solid|cborder=blue}} {{Tl|Documentation/nodoc}} wird dann eingebunden, wenn die Dokumentationsunterseite nicht vorhanden ist. {{Div-dotted}}{{Documentation/nodoc}}</div></div> =='"`UNIQ--h-25--QINU`"' Formatierungs- und Bearbeitungsvorlagen == *{{Tl|Bearbeiten}}: erzeugt eine Linkleiste für Darstellen, Bearbeiten, Seiteninformation, Cache löschen *{{Tl|Verborgen}}: erzeugt einen Hinweis darauf, dass die Vorlage nur auf eingebundenen Seiten sichtbar ist, dies wird durch das Tag <code><nowiki><includeonly></includeonly></nowiki></code> erreicht. *{{Tl|ShowMe}}: zeigt den Wikitext einer Seite per {{ref|url=https://www.mediawiki.org/wiki/Help:Magic_words#Transclusion_modifiers|utext=<code><nowiki>{{msgnw:}}</nowiki></code>}} an *{{Tl|ShowSub}}: zeigt alle Unterseiten bzw. Verwendungen einer Vorlage an *{{Tl|Klappbox}}: Text in einer einklappbaren Box *{{Tl|Border-radius}} *{{Tl|Box-shadow}} *{{Tl|Clear}} *{{Tl|CreateNewPage}} *{{Tl|Round corners}} *{{Tl|Span-dotted}} *{{Tl|Tl}} *{{Tl|Tlx}} =='"`UNIQ--h-26--QINU`"' Wikicode dieser Seite == {{ShowMe}}

{{Vorlagendokumentationsvorlagen}}

Vorlagen, die für die Dokumentation von Vorlagen benötigt werden:

Dok, Dokumentation, Ichselber, Lorem, Parameter, ShowMe, ShowSub, Vorlagendokumentation, Vorlagendokumentationsvorlagen