Vorlage:Cat/Doku
 | Dies ist eine nachgeordnete Seite der Dokumentation von Vorlage:Cat. Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Vorlage-Seite ist. |
Funktion
Die Vorlage {{C}} und ihre Geschwister dienen dazu, Verweise auf Kategorien darzustellen. Somit entfällt die Angabe des Namensraums und man kann den führenden Doppelpunkt nicht vergessen, wenn man nur Verlinken und eine Kategorisierung vermeiden möchte. Das ist einfacher als die Eingabe von [[:Kategorie:Malaysia|Malaysia]], welche ebenfalls Malaysia erzeugt.
Verwendung
Folgendermaßen können die Vorlagen eingesetzt werden:
{{C|Malaysia}}ergibt: Malaysia{{Cat|Malaysia}}ergibt: Kategorie:Malaysia{{C|Malaysia|Kategorie für Malaysia}}ergibt: Kategorie für Malaysia{{Cl|Malaysia}}ergibt: Kategorie:Malaysia{{Cls|Malaysia}}ergibt: Kat:Malaysia
Für Vorlagenkategorien gibt es eine separate Kurzform:
{{Ct|Malaysia}}ergibt: Vorlagen:Malaysia
Für Diskussionen kann folgende Variante sinnvoll sein:
{{Lc|Malaysia}}ergibt: Kategorie:Malaysia (Bearbeiten | Diskussion | Versionen | Links | Beobachten | Logs){{Lcs|Malaysia}}ergibt: (Bearbeiten Diskussion Links Versionen)
Links auf Vorlagen
BearbeitenFunktion
Die Vorlagen {{Tl}}, {{Tlg}} und ihre Geschwister dienen dazu, Verweise auf andere Vorlagen darzustellen. Somit entfällt die Angabe des Namensraums sowie die Verwendung von Tags wie <nowiki>...</nowiki> oder <code>...</code>. Damit die verlinkten Seiten als Vorlagen erkennbar sind, werden sie in funktionslosen geschweiften Klammern dargestellt. Somit bieten sie sich auch als Kopiervorlage an. Verwendung finden sie auf Hilfe- und Dokumentationsseiten sowie in Diskussionen.
Die einfachste Vorlage ist {{Tl}}, die eine Vorlage verlinkt und in geschweiften Klammern darstellt. Beispiel für eine Ausgabe: {{VCard}}
Erweiterte Vorlagen bieten zusätzliche Formatierungen und Ausgaben. Die nachfolgende Übersicht zeigt die verfügbaren Varianten. Sie basieren auf {{Tlg}}, die mit vielen Parametern bestückt werden kann. Diese können, neben der eigentlichen Vorlage auch bis zu 10 ihrer Parameter darstellen.
Übersicht über die Vorlagen
| Typ → | Verlinkt | Nicht verlinkt | Linkt mit Ersetzung | Verlinkt inklusive der ersten Klammer | Verlinkt mit alternativem Text | |
|---|---|---|---|---|---|---|
| Text Stil ↓ | {{tlg}} option1
|
— | nolink=yes
|
subst=yes
|
braceinside=yes
|
alttext=FOO
|
| Normal | — | {{tl}} · {{tlp}}2 · {{tlg}}1, 2
|
{{tlf}}2
|
{{tls}} · {{tlsp}}
|
{{tn}}
|
{{tla}}
|
Code
|
code=yes ortt=yes
|
{{tlx}}
|
{{tlc}}2 · {{tld}} · {{tnull}}
|
{{tlxs}} · {{tlxsp}}
|
||
| Fett | bold=yes
|
{{tlb}}
|
||||
| Kursiv | italic=yes
|
{{tli}}
| ||||
Fetter Code
|
bold=yes|code=yes
|
{{tlxb}}
|
{{tlcb}}
|
|||
Kursiver Code
|
italic=yes|code=yes
|
{{tlxi}}
|
{{tlci}}
| |||
{{tlg}} ist die allgemeine Vorlage, die alle mögliche Kombinationen an Textsstil und Linkarten erlaubt.2 = Schützt vor Zeilenumbrüchen durch die Verwendung des Tags
<span class="nowrap">...</span>
| Typ → | Verlinkt | Nicht verlinkt | Linkt mit Ersetzung | Verlinkt inklusive der ersten Klammer | Verlinkt mit alternativem Text | |
|---|---|---|---|---|---|---|
| Text Stil ↓ | — | nolink=yes
|
subst=yes
|
braceinside=yes
|
alttext=FOO
| |
| Normal | — | {{VCard}} · {{VCard}} · {{VCard}} | {{VCard}} | {{subst:VCard}} · {{subst:VCard}} | {{VCard}} | {{Listing}} |
Code
|
code=yes ortt=yes
|
{{VCard}}
|
{{VCard}} · {{VCard}} · {{VCard}}
|
{{subst:VCard}} · {{subst:VCard}}
|
||
| Fett | bold=yes
|
{{VCard|param}} | ||||
| Kursiv | italic=yes
|
{{VCard|param}} | ||||
Fetter Code
|
bold=yes|code=yes
|
{{VCard|param}}
|
{{VCard|param}}
|
|||
Kursiver Code
|
italic=yes|code=yes
|
{{VCard|param}}
|
{{VCard|param}}
| |||
Bei der Dokumentation von Hilfsvorlagen, die im allgemeinen sehr kurz sind, kannst du statt der Vorlage {{Tl}} auf {{Tn}} zurückgreifen. Dort werden die inneren Klammern mit in den Link aufgenommen. So lässt sich besser auf die Vorlage klicken, da der Zielbereich nicht so schmal ist.
- Hinweis
- Der Parameter
|bold=wirkt nur auf die Vorlagenbezeichnung - Der Parameter
|italic=wirkt nur auf die Parameter
- Stilvergleich
{{tl|Dokumentation|Parameter}}…ergibt… {{Dokumentation}} Beachte! Eine Darstellung der Parameter erfolgt hier nicht.{{tlp|Dokumentation|Parameter}}…ergibt… {{Dokumentation|Parameter}}{{tlf|Dokumentation|Parameter}}…ergibt… {{Dokumentation|Parameter}}{{tlc|Dokumentation|Parameter}}…ergibt…{{Dokumentation|Parameter}}{{tlx|Dokumentation|Parameter}}…ergibt…{{Dokumentation|Parameter}}{{tli|Dokumentation|Parameter}}…ergibt… {{Dokumentation|Parameter}}{{tlb|Dokumentation|Parameter}}…ergibt… {{Dokumentation|Parameter}}
Vorlagen zur Beschreibung von Vorlagen
- Beispiele
Für die Darstellung von Beispielanwendungen gibt es zwei Vorlagen, die eine Vorlage nach dem Schema <Beispielcode> ergibt <Ausgabe> dokumentiert. Für weniger komplexe Vorlagen (z. B. namenslose Parameter) ist dieses Werkzeug gut geeignet. Beide Vorlagen packen den Beispieltext in ein <code>...</code> Tag. Bei kompliziert anzuwendenden Vorlagen versagen diese Hilfsmittel unter Umständen. Probiere es einfach aus.
{{Tlcex|<Vorlage>|<Parameter>|...}}– Ausgabe ohne Link auf die Vorlage (für die eigene Dokumentationsseite){{Tlxex|<Vorlage>|<Parameter>|...}}– Ausgabe mit Link zur Vorlage (für alle anderen Fälle)
Anwendung: {{Tlxex|Red|roter Text}} ergibt folgendes: {{Red|roter Text}} ergibt: roter Text
- Parameter
{{Para}}– dient der ausführlichen Dokumentation von Paramatern, die in Vorlagen verwendet werden
Verweise auf Schwesterprojekte
Die Vorlage {{Tl2}} kann auch auf Schwesterprojekte verweisen.
- Verwendung:
{{Tl2|lang=Sprachversion|sister=projektname|Name der Vorlage}} - Beispiele:
| Code | Ergebnis |
|---|---|
{{Tl|Dummy}}
|
{{Dummy}} |
{{Tl2|Dummy}}
|
{{Dummy}}
|
{{Tl2|sister=M|3x}}
|
{{3x}}
|
{{Tl2|sister=wikibooks|lang=de|WP}}
|
{{WP}}
|
Siehe auch
Bearbeiten{{Tl2}}– Wie {{Tl}}, kann aber auf jedes beliebige Schwesterprojekt verlinken, indem man Projekt und Sprachversion als Parameter übergibt.{{Tlt}}– Wie {{Tl}}, aber erzeugt daneben in Klammern noch einen Link zur zugehörigen Diskussionsseite.{{Tfd links}}– Sie kann man benutzen, wenn eine Vorlage zum Löschen vorgeschlagen wird. Sie erzeugt neben dem Link zur Vorlage auch Links zum Sandkasten, Diskussionsseite, Versionsgeschichte und Bearbeitung.{{T links}}– Gut für den Start von Diskussionen. Sie erzeugt neben dem Link zur Vorlage auch Links zum Sandkasten, Diskussionsseite, Versionsgeschichte und Bearbeitung.{{Lts}}– Erzeugt neben einem Link zur Vorlage vier klein geschriebene Links für Bearbeiten, Diskussion, Links und Versionsgeschichte.
</includeonly>