Vorlage:Tlg

Dokumentation für die Vorlage {{Tlg}}[Ansicht] [Bearbeiten] [Versionsgeschichte] []

Funktion

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.

Die Basis-Vorlage {{Tlg}}

{{tlg}} (template link, general) ist die allgemeine Vorlage zur Verlinkung von Vorlagen. Sie ist die Basis für alle Vorlagen nach dem Schema {{tl*}}, z. B. {{tl}}, {{tlx}} oder {{tlb}}. Folgende Parameter sind möglich:

• |code=yes Benutzt das Tag <code>...</code> für die Darstellung (normalerweise ein monospaced Font). Anwendung z. B. bei {{tlc}} {{tlx}} und {{tlxb}}
• |bold=yes Fetter Text für die Vorlagenbezeichnung (und nur die), z. B. für {{tlb}} und {{tlxb}}
• |italic=yes Schreibt die Parameter kursiv (nur die Parameter), z. B. für {{tlxi}}
• |nolink=yes Verlinkt nicht auf die Vorlage, sondern nennt sie nur, z. B. für {{tlf}}, {{tld}}, und {{tlc}}
• |braceinside=yes packt das inner Paar der geschweiften Klammern mit in den Link (für {{tn}})
• |subst=yes Fügt ein subst: hinzu (für {{tls}})
• |alttext=FOO gibt einen alternativen Text für die Ausgabe an (für{{tla}})
• |nowrap=yes verhindert Zeilenumbrüche

Beispiele

Code	Result	Remark
{{Tlg|Abc}}	{{Abc}}
{{Tlg|abC}}	{{abC}}	Vorlagenbezeichnungen unterscheiden zwischen Groß- und Kleinschreibung...
{{Tlg|abc}}	{{abc}}	... obwohl der Anfangsbuchstabe nicht zwischen Groß- und Kleinschreibung unterscheidet.
{{Tlg|Dummy}}	{{Dummy}}
{{Tlg|Dummy|code=yes}}	{{Dummy}}	Code
{{Tlg|Dummy|bold=yes}}	{{Dummy}}	fett
{{Tlg|Dummy|one|italic=yes}}	{{Dummy|one}}	kursiv
{{Tlg|Dummy|nolink=yes}}	{{Dummy}}
{{Tlg|Dummy|subst=yes}}	{{subst:Dummy}}
{{Tlg|Dummy|braceinside=yes}}	{{Dummy}}
{{Tlg|Dummy|alttext=Link zur Dummy-Vorlage}}	{{Link zur Dummy-Vorlage}}
{{Tlg|Dummy|bold=yes|code=yes|braceinside=yes}}	{{Dummy}}
{{Tlg|Dummy|one}}	{{Dummy|one}}
{{Tlg|Dummy|one|two}}	{{Dummy|one|two}}
{{Tlg|Dummy|bold=yes|code=yes|one|two}}	{{Dummy|one|two}}	Kombination benannter und anonymer PArameter ist möglich …
{{Tlg|Dummy|one|two|bold=yes|code=yes}}	{{Dummy|one|two}}	… in beliebiger Reihenfolge …
{{Tlg|Dummy|one|code=yes|two|bold=yes|three}}	{{Dummy|one|two|three}}	… sogar gemischt …
{{Tlg|Dummy|one|code=yes|two|bold=yes|three|italic=yes}}	{{Dummy|one|two|three}}	… in verschiedener Kombination
{{Tlg|Dummy|1|2|3|4|5|6|7|8|9|10}}	{{Dummy|1|2|3|4|5|6|7|8|9|10}}
{{Tlg|Dummy|1|2|3|4|5|6|7|8|9|10|11}}	{{Dummy|1|2|3|4|5|6|7|8|9|10|…}}	bis zu 10 Parameter kann man übergeben, danach …
{{Tlg|Dummy|1|2|3|4|5|6|7|8|9|10|11}}	{{Dummy|1|2|3|4|5|6|7|8|9|10|11}}	| für mehr
{{Tlg|convert|<nowiki>14|m|ftin|abbr=out|sp=us</nowiki>}}		Braucht man mehr, ist ein nowiki-String notwendig.
{{Tlg}}	{{Tlg}}	ohne Argumente wird der aktuelle Seitenname angewendet
{{Tlg|Dummy|x=u}}	{{Dummy}}	ein = wird so nicht funktionieren.
{{Tlg|Dummy|x&#61;u}}	{{Dummy|x=u}}	&#61; ist ok
{{Tlg|Dummy|x{{=}}u}}	{{Dummy|x=u}}	{{=}} is ok
{{Tlg|Dummy|x<nowiki>=</nowiki>u}}	{{Dummy|x<nowiki>=</nowiki>u}}	sticky nowiki is ok
{{Tlg|Dummy||two||}}	{{Dummy||two||}}	leere Parameter funktionieren, auch am Ende
{{Tlg|Dummy|3=two|2=one}}	{{Dummy|one|two}}	rechts nach links ist ok

Übersicht über die Vorlagen

Vorlagen für die Verlinkung zu 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 or tt=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}}

NOTES:  1 = {{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>

Beispiele für die Verwendung

	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 or tt=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}}

Tipp

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.

Bsp.: {{!!}} lässt sich schwerer anklicken als {{!!}}, da man genauer zielen muss.

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
  • {{Para|bild}} ergibt: |bild=
  • {{Para||bild}} ergibt: |bild
  • {{Para|bild|Berlin.jpg}} ergibt: |bild=Berlin.jpg

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

• {{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.

Hinweise

• Die obige Dokumentation wurde aus der Seite Vorlage:Dokumentation Links auf Vorlagen eingefügt. (bearbeiten | Versionsgeschichte) Die Kategorien für diese Vorlage sollten in der Dokumentation eingetragen werden. Die Interwiki-Links sollten auf Wikidata eingepflegt werden.
• Liste der Unterseiten