Vorlage:Dokumentation/Doku: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Arend (Diskussion • Beiträge) (Die Seite wurde neu angelegt: „<noinclude>{{Dokumentation/Dokuseite}} </noinclude> Die Trennung von Programmcode und Dokumentation macht den Quelltext einer Vorlage übersichtlicher und entlas...“) |
Arend (Diskussion • Beiträge) Keine Bearbeitungszusammenfassung |
||
| (2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
== Anwendung == | == Anwendung == | ||
Man schreibt <code><noinclude><nowiki>{{Dokumentation}}</nowiki></noinclude></code> an das Ende einer Vorlage. | Man schreibt <code><noinclude><nowiki>{{Dokumentation}}</nowiki></noinclude></code> an das Ende einer Vorlage.<ref>Hierdurch wird die in der Unterseite '''/Doku''' befindliche Dokumentation der Vorlage eingebunden.</ref> | ||
In der Unterseite '''/Doku''' der Vorlage beginnt man mit: | In der zum Zwecke der Dokumentation zu erstellenenden Unterseite '''/Doku''' der Vorlage beginnt man mit: | ||
<code><noinclude><nowiki>{{Dokumentation/Dokuseite}}</nowiki></noinclude></code> | <code><noinclude><nowiki>{{Dokumentation/Dokuseite}}</nowiki></noinclude></code><ref>Hierdurch wird in einer Infobox auf die Vorlage verwiesen (gewissermaßen der Rücksprung auf die eigentliche Vorlage) und die (Unter)Seite als [[:Kategorie:Vorlagendokumentation|Vorlagendokumentation]] kategorisiert.</ref> | ||
und lässt anschließend den Text folgen, der die Vorlage und ihre Anwendung dokumentiert. | 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''' | |||
:<code><includeonly><nowiki>...Programmcode der Vorlage...</nowiki></includeonly><noinclude></code><br /> | |||
:<code><nowiki>{{Dokumentation}}</nowiki></code><br /> | |||
:<code></noinclude></code> | |||
=== Dokumentation === | |||
Name: '''Vorlage:ABC/Doku''' | |||
:<code><noinclude><nowiki>{{Dokumentation/Dokuseite}}</nowiki></noinclude></code><br /> | |||
:<code><nowiki>Diese Vorlage dient dazu ...</nowiki></code><br /> | |||
:<code><nowiki>== Parameter ==</nowiki></code><br /> | |||
:<code><nowiki>1. ...</nowiki></code><br /> | |||
:<code><nowiki>== Beispiel ==</nowiki></code><br /> | |||
:<code><nowiki>=== Aufruf ===</nowiki></code><br /> | |||
:<code><code><nowiki><nowiki>{{ABC|...}}</nowiki></nowiki></code></code><br /> | |||
:<code><nowiki>=== Anzeige ===</nowiki></code><br /> | |||
:<code><nowiki>{{ABC|...}}</nowiki></code><br /> | |||
---- | |||
<references /> | |||
Aktuelle Version vom 3. Februar 2011, 22:09 Uhr
|
Diese Seite ist die Dokumentations-Unterseite der Vorlage: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.