Vorlage:Dokumentation: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Arend (Diskussion • Beiträge) Keine Bearbeitungszusammenfassung |
Arend (Diskussion • Beiträge) Keine Bearbeitungszusammenfassung |
||
Zeile 1: | Zeile 1: | ||
'''<div style="border:1px solid #aaaaaa;padding:5px; margin-bottom:0.5em; padding:0.5em; padding-top:0; clear:left" id="Vorlage_Dokumentation">[[{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} Bearbeiten]]</span> <big>Dokumentation</big>''' | '''<div style="border:1px solid #aaaaaa;padding:5px; margin-bottom:0.5em; padding:0.5em; padding-top:0.5em; clear:left" id="Vorlage_Dokumentation">[[{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} Bearbeiten]]</span> <big>Dokumentation</big>''' | ||
<hr /> | <hr /> | ||
{{#ifexist: {{SUBJECTPAGENAME}}/Doku|{{{{SUBJECTPAGENAME}}/Doku}}}} | {{#ifexist: {{SUBJECTPAGENAME}}/Doku|{{{{SUBJECTPAGENAME}}/Doku}}}} | ||
</div> | </div> | ||
__NOTOC__ | |||
__NOEDITSECTION__ |
Version vom 3. Februar 2011, 18:18 Uhr
[Bearbeiten] Dokumentation
Die Trennung von Programmcode und Dokumentation macht den Quelltext einer Vorlage übersichtlicher und entlastet vor allem den Parser.
Anwendung
Man schreibt <noinclude>{{Dokumentation}}</noinclude>
an das Ende einer Vorlage.[1]
In der zum Zwecke der Dokumentation zu erstellenenden Unterseite /Doku der Vorlage beginnt man mit:
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
[2]
und lässt anschließend den Text folgen, der die Vorlage und ihre Anwendung dokumentiert.
Beispiel
In diesem fiktiven Beispiel soll die Vorlage den Namen ABC bekommen.
Vorlage
Name: Vorlage:ABC
<includeonly>...Programmcode der Vorlage...</includeonly><noinclude>
{{Dokumentation}}
</noinclude>
Dokumentation
Name: Vorlage:ABC/Doku
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Diese Vorlage dient dazu ...
== Parameter ==
1. ...
== Beispiel ==
=== Aufruf ===
<code><nowiki>{{ABC|...}}</nowiki></code>
=== Anzeige ===
{{ABC|...}}
- ↑ Hierdurch wird die in der Unterseite /Doku befindliche Dokumentation der Vorlage eingebunden.
- ↑ Hierdurch wird in einer Infobox auf die Vorlage verwiesen (gewissermaßen der Rücksprung auf die eigentliche Vorlage) und die (Unter)Seite als Vorlagendokumentation kategorisiert.