Vorlage:Dokumentation: Unterschied zwischen den Versionen

aus GenWiki, dem genealogischen Lexikon zum Mitmachen.
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „[[{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} Bearbeiten]]</span> '''Dokumentation''' {{#ifexist: {{SUBJECTPAGENAME}}/Doku|{{{{SUBJECTPAGENAME}}/D...“)
 
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
&#x5b;[{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} Bearbeiten]&#x5d;</span> '''Dokumentation'''
<div style="border:1px solid #aaaaaa;padding:5px; margin-bottom:0.5em; padding:0.5em; padding-top:0; clear:left" id="Vorlage_Dokumentation">&#x5b;[{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} Bearbeiten]&#x5d;</span> '''Dokumentation'''
 
<hr />
{{#ifexist: {{SUBJECTPAGENAME}}/Doku|{{{{SUBJECTPAGENAME}}/Doku}}}}
{{#ifexist: {{SUBJECTPAGENAME}}/Doku|{{{{SUBJECTPAGENAME}}/Doku}}}}
</div>

Version vom 3. Februar 2011, 18:10 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|...}}



  1. Hierdurch wird die in der Unterseite /Doku befindliche Dokumentation der Vorlage eingebunden.
  2. 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.