Quelltext der Seite Vorlage:VT/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
<!-- Diese Vorlage ist noch in einem sehr frühen Entwicklungstatus und sollte daher noch nicht in Artikeln verwendet werden! -->
Die Vorlage dient zur '''Ausgabe einer übersichtlichen sortierbaren Versionstabelle''', beispielsweise um Software-Releases aufzuführen.

'''Abhängigkeiten:''' Die Vorlage benutzt und benötigt eine zweite Vorlage namens [[Vorlage:VT/Zeile|VT/Zeile]], welche die Tabellenzeilen schreibt. „<code>VT/Zeile</code>“ kann beliegig oft wiederholt werden, für jede Version die beschrieben werden soll, eine Zeile.

== Einsatzbereiche ==
Abstrakt betrachtet ist eine Versionstabelle eine dreispaltige Tabelle, mit je einer Spalte für
# Sortierung für die Versionsnummer
# die Versionsbezeichnung oder -nummer,
# das Veröffentlichungsdatum, den Veröffentlichungsmonat oder das Veröffentlichungsjahr und
# eine Kurzbeschreibung der Version.

Auch wenn diese Vorlage aus einer Versionstabelle für eine Linux-Distribution entstanden ist, also aus einer Tabelle von  Softwareversionen, ist sie genauso für andere Themenbereiche geeignet, deren Objekte sich durch diese drei Spalten beschreiben lassen. Das können Geräteversionen wie Modelle einer Automobilreihe oder Weinjahrgänge eines Weinguts sein. Auch ein Wein hat, um beim letzten Beispiel zu bleiben,
# Sortierung für die Bezeichnung
# eine Bezeichnung,
# einen Markteinführungstermin oder einen Jahrgang und
# eine Kurzbeschreibung.
Die Vorlage trägt ihrem vielfältigen Einsatzpotential dadurch Rechnung, dass sie durch ihre verschiedenen [[#Parameter|Aufrufparameter]] gut anpassbar ist.

== Kopiervorlagen ==

'''Kurze Standardform'''

Mit „<code>|refurl=</code>“ müssen immer auch „<code>|reftitel=</code>“ und „<code>|refzugriff=</code>“ angegeben werden! Diese Daten zur Quellenangabe müssen vorm Ende der Versionszeilen-Vorlage und hinter allen VT/Zeilen stehen.
<code><pre style="white-space:pre-wrap;">{{VT |
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Hier eine sehr kurze Beschreibung einfügen}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
|refurl=http://... |reftitel=Webseitentitel |refzugriff=2014-02-17}}</pre></code>


'''Kurze Standardform mit abweichender Überschrift'''

Auch eine abweichende Tabellenüberschrift muss in der Versionstabellen-Vorlage immer nach allen VT/Zeilen stehen.
<code><pre style="white-space:pre-wrap;">{{VT |
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Hier eine sehr kurze Beschreibung einfügen}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
|ueberschrift=Meine Tabellenüberschrift |refurl=http://... |reftitel=Webseitentitel |refzugriff=2014-02-17}}</pre></code>


'''Tabelle mit abwechselnder Zeilenhintergrundfarbe'''

Vorm Ende von VT/Zeile ist jeweils „<code>|1</code>“ oder „<code>|2</code>“ eingefügt!
<code><pre style="white-space:pre-wrap;">{{VT |
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Hier eine sehr kurze Beschreibung einfügen|1}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung|2}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung|1}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung|2}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung|1}}
|refurl=http://... |reftitel=Webseitentitel |refzugriff=2014-02-17}}</pre></code>


'''Mit abweichender Überschrift und anderen Spaltenüberschriften'''
<code><pre style="white-space:pre-wrap;">{{VT |
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Hier eine sehr kurze Beschreibung einfügen}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
|ueberschrift=Meine Tabellenüberschrift |text01=Nummer |text02=Releasedatum |text03=Wesentliche Änderungen
|refurl=http://... |reftitel=Webseitentitel |refzugriff=2014-02-17}}</pre></code>


'''Kopiervorlage mit allen möglichen Parametern'''
<code><pre style="white-space:pre-wrap;">{{VT |
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}
{{VT/Zeile|VersnrZahl|Versnr|JJJJ-MM-TT|Kurzbeschreibung}}  <!-- LESEN SIE DIE PARAMETER-DOKUMENTATION UND  -->
|ueberschrift=  <!-- Die Tabellenüberschrift               SETZEN SIE DIE PARAMETER SPARSAM EIN! -->
|caption=       <!-- none unterdrückt die Tabellenüberschrift -->
|text01=        <!-- Überschrift der 1. Tabellenspalte -->
|text02=        <!-- Überschrift der 2. Spalte -->
|text03=        <!-- Überschrift der 3. Spalte -->
|refurl=        <!-- Eine Webadresse: http://... -->
|reftitel=      <!-- Webseitentitel -->
|refzugriff=    <!-- 2014-02-17 -->
|rules=         <!-- none unterdrueckt die Gitterlinien in der Tabelle. -->
|stil=          <!-  Spezielles Darstellungsformat. (Nicht mit "rules=" einsetzen.) -->
|breite=        <!-- Die Tabellenbreite. -->
}}</pre></code>

== Parameter ==

=== Wo die Parameter stehen dürfen ===
Alle Parameter mit Ausnahme der Zeilendefinitionen '''müssen''' unter der letzten Zeilendefinition und vor den beiden schließenden geschweiften Klammern der Vorlage VT eingesetzt werden.

==== Beispiel ====
{| class="toptextcells" width="100%" cellspacing="0" cellpadding="2" style="border:solid thin #808080;"
! style="background-color:#D2D5DA;color:black;" | Kodeabschnitt
! style="background-color:#D3D3D3;color:black;" | Eingegebener Kode
|-
| style="padding-top:10px;background-color:#EDF0F6;color:black;text-indent:6px;" | Vorlage:VT beginnt
| style="padding:10px 15px 0 15px;background-color:#F0F0F0;color:black;font-family:'New Courier',monospace;" | <nowiki>{{VT |</nowiki>
|-
| style="background-color:#F6F9FF;color:black;text-indent:6px;" | 1. Zeile
| style="padding:0 15px;background-color:#F9F9F9;color:black;font-family:'New Courier',monospace;" | <nowiki>{{VT/Zeile|100|1.0|Sep 1983|</nowiki><br /><nowiki>* '''SCO Xenix System 3''' mit Unterstützung für [[IBM Personal Computer XT|IBM XT]]|1}}</nowiki>
|-
| style="background-color:#EDF0F6;color:black;text-indent:6px;" | 2. Zeile
| style="padding:0 15px;background-color:#F0F0F0;color:black;font-family:'New Courier',monospace;" | <nowiki>{{VT/Zeile|221|2.2.1|Feb 1988||2}}</nowiki>
|-
| style="background-color:#F6F9FF;color:black;text-indent:6px;" | 3. Zeile
| style="padding:0 15px;background-color:#F9F9F9;color:black;font-family:'New Courier',monospace;" | <nowiki>{{VT/Zeile|230|2.3.0|Feb 1989|</nowiki><br /><nowiki>* Verbesserte Hardwareunterstützung, [[Video Graphics Array|VGA]]</nowiki><br /><nowiki>* Unterstützung für [[Datenstrom|Streams]]|1}}</nowiki>
|-
| style="border:dashed blue;border-width:1px 0 1px 1px;background-color:#EDF0F6;color:#222;text-indent:6px;font-weight:bold;" | Optionen
| style="border:dashed blue;border-width:1px 1px 1px 0;padding:0 15px;background-color:#F0F0F0;color:#222222;font-family:'New Courier',monospace;font-weight:bold;" | <nowiki>|breite=75% |rules=none</nowiki><br /><nowiki>|kopffarbe=blau |text01=Release |text02=Datum |text03=Beschreibung / Änderungen</nowiki><br /><nowiki>|refurl=http://... |reftitel=Webseitentitel |refzugriff=2014-02-17</nowiki>
|-
| style="padding-bottom:10px;background-color:#F6F9FF;color:black;text-indent:6px;" | Vorlage:VT endet
| style="padding:0 15px 10px 15px;background-color:#F9F9F9;color:black;font-family:'New Courier',monospace;" | <nowiki>}}</nowiki>
|}

=== Welche Parameter es gibt ===
{{VT/Doku/Parameterliste}}

<!-- Gewählt werden können
# Die Hintergrundfarbe alle Spaltenüberschriften und
# der Text jeder Spaltenüberschrift.

Genau zwei Farbtöne für die Hintergrundfarbe der Spaltenüberschriften sind möglich. Die Standardfarbe, ein Grünton, wird immer benutzt, wenn nichts anderes angegeben wird. Für einen Blauton, ist der Parameter <code>|kopffarbe=blau</code> anzugeben.

Der Text der Spaltenüberschriften wird durch die Angabe <code>|text01=</code> mit einem Text dahinter geändert. Die Eingabe kann beispielsweise so aussehen:

{{VT |
{{VT/Zeile|Gloria|Dezember 2013|Verbesserte Bildschirmausgabe}}
|text01=Versionsname |text02=Veröffentlichungsdatum |text03=Neue Features |kopffarbe=blau}} -->

== Beispiele ==

<pre style="white-space:pre-wrap;">{{VT |
{{VT/Zeile|100|1.0  |2013-03-13|&nbsp;}}
{{VT/Zeile|101|1.0.1|2013-03-14|Fehler bei USB-Tastaturen behoben.}}
{{VT/Zeile|102|1.0.2|2013-03-23|Behob kleinere Fehler.}}
{{VT/Zeile|103|1.0.3|2013-04-26|Programme für barrierefreie Nutzung; Möglichkeit aus der LiveCD zu installieren.}}
{{VT/Zeile|104|1.0.4|2013-07-25|Zusätzliche Programme; Updates.}}
{{VT/Zeile|105|1.0.5|2013-09-05|}}
{{VT/Zeile|106|1.0.6|2014-01-09|Möglichkeit einer verschlüsselten Installation.}}
|text03=Neu<erungen
|refurl=http://www.kali.org/kali-linux-releases/ |reftitel=Kali Linux Releases |refzugriff=2014-02-14
}}</pre>

{{VT |
{{VT/Zeile|100|1.0  |2013-03-13|&nbsp;}}
{{VT/Zeile|101|1.0.1|2013-03-14|Fehler bei USB-Tastaturen behoben.}}
{{VT/Zeile|102|1.0.2|2013-03-23|Behob kleinere Fehler.}}
{{VT/Zeile|103|1.0.3|2013-04-26|Programme für barrierefreie Nutzung; Möglichkeit aus der LiveCD zu installieren.}}
{{VT/Zeile|104|1.0.4|2013-07-25|Zusätzliche Programme; Updates.}}
{{VT/Zeile|105|1.0.5|2013-09-05|}}
{{VT/Zeile|106|1.0.6|2014-01-09|Möglichkeit einer verschlüsselten Installation.}}
|text03=Neuerungen
|refurl=http://www.kali.org/kali-linux-releases/ |reftitel=Kali Linux Releases |refzugriff=2014-02-14
}}

== Einzelnachweise die von den Beispielen erzeugt werden ==
<references />