Vorlage:Tlg: Unterschied zwischen den Versionen

Aktuelle Version vom 27. Januar 2023, 06:41 Uhr

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

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. Vorlage:Dokumentation Links auf Vorlagen/Tlg

Ü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}}` option¹	—	`nolink=yes`	`subst=yes`	`braceinside=yes`	`alttext=FOO`
Normal	—	`{{tl}}` · `{{tlp}}`² · `{{tlg}}`^{1, 2}	`{{tlf}}`²	`{{tls}}` · `{{tlsp}}`	`{{tn}}`	`{{tla}}`
`Code`	`code=yes` or `tt=yes`	`{{tlx}}`	`{{tlc}}`² · `{{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}}`

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.
Doku anlegen -Testseite anlegen -Editnotice anlegen -Wartungsseite anlegen
Liste der Unterseiten

@@ Zeile 1: / Zeile 1: @@
-__NOTOC__
 <includeonly><!--
-   -- begin tt face if tt=yes given
+ -->{{#if:{{{nowrap|}}}        |<span class="nowrap">}}<!--
--->{{#if:{{{tt|}}}|<tt>}}<!--
+ -->{{#if:{{{code|{{{tt|}}}}}} |<code> |{{#if:{{{plaincode|}}}|<code style="border:none;background:transparent;">}} }}<!--
-   -- opening brace unless braceinside=yes
+ -->{{#if:{{{braceinside|}}}   | |<nowiki>{{</nowiki>}}<!--
--->{{#if:{{{braceinside|}}}||<nowiki>{{</nowiki>}}<!--
+ -->{{#if:{{{subst|}}}         |[[:w:en:Help:Substitution|subst]]:}}<!--
-   -- add subst prefix, if subst=yes given
--->{{#if:{{{subst|}}}|[[Help:Substitution|subst]]:}}<!--
-   -- begin boldface if bold=yes given
--->{{#if:{{{bold|}}}|'''}}<!--
-   -- begin link if not nolink=yes; add any LANG and SISTER prefixes
--->{{#if:{{{nolink|}}}||{{{{!(}}{{!(}}{{{LANG|}}}{{{SISTER|}}}<!--
-   -- specify page to link to (unless nolink=yes)
--->{{#if:{{{1|}}}|{{#if:{{{anypage|}}}||{{ns:Template}}:}}{{{1|}}}|{{FULLPAGENAME}}}}&#124;}}<!--
-   -- opening brace if braceinside=yes
--->{{#if:{{{braceinside|}}}|<nowiki>{{</nowiki>}}<!--
-   -- surface text of link
--->{{{1|{{#ifeq:{{NAMESPACE}}|{{ns:Template}}|{{PAGENAME}}|{{FULLPAGENAME}}}}}}}<!--
-   -- closing brace if braceinside=yes
--->{{#if:{{{braceinside|}}}|<nowiki>}}</nowiki>}}<!--
-   -- end of link, unless nolink=yes
--->{{#if:{{{nolink|}}}||]]}}<!--
-   -- end boldface if bold=yes
--->{{#if:{{{bold|}}}|'''}}<!--
-   -- add the remaining parameters
--->{{#if:{{{2|}}}|
-&#124;{{{2}}}
-}}<!--
--->{{#if:{{{3|}}}|
-&#124;{{{3}}}
-}}<!--
--->{{#if:{{{4|}}}|
-&#124;{{{4}}}
-}}<!--
--->{{#if:{{{5|}}}|
-&#124;{{{5}}}
-}}<!--
--->{{#if:{{{6|}}}|
-&#124;{{{6}}}
-}}<!--
--->{{#if:{{{7|}}}|
-&#124;{{{7}}}
-}}<!--
--->{{#if:{{{8|}}}|
-&#124;{{{8}}}
-}}<!--
--->{{#if:{{{9|}}}|
-&#124;{{{9}}}
-}}<!--
--->{{#if:{{{10|}}}|
-&#124;{{{10}}}
-}}<!--
--->{{#if:{{{11|}}}|
-&#124;{{{11}}}
-}}<!--
--->{{#if:{{{12|}}}|
-&#124;''...''
-}}<!--
-   -- closing brace unless braceinside=yes
--->{{#if:{{{braceinside|}}}||<nowiki>}}</nowiki>}}<!--
-   -- end tt face if tt=yes given
--->{{#if:{{{tt|}}}|</tt>}}<!--
-   -- end
---></includeonly><noinclude>
-==Explanation==
+ -->{{#if:{{{bold|{{{boldlink|{{{boldname|}}}}}}}}} |'''}}<!--
-This template is a general template for inserting a template link.
+ -->{{#if:{{{nolink|}}} |<!--then omit template link, else:
+  -->| {{#if:{{{braceinside|}}} |<nowiki>{</nowiki>}}<!--
+       -->{{!((}}:<!--(start building link with "[[:")
+                   -->{{#ifeq:{{padleft:|1|{{{1}}}}}|: <!--i.e. if {{{1}}}'s first character is a colon,
+              then:--> |{{FULLPAGENAME:{{{1}}}}}<!--
+              else:--> |{{#switch:{{NAMESPACE:{{#if:{{{1|}}}|{{{1}}}|{{FULLPAGENAME}}}}}}
+                         | {{ns:0}} = {{ns:10}}:{{#if:{{{1|}}}|{{PAGENAME:{{{1}}}}}|{{PAGENAME}}}}
+                         | #default = {{#if:{{{1|}}}|{{FULLPAGENAME:{{{1}}}}}|{{FULLPAGENAME}}}}
+                      }}}}<!--
+       -->{{!}}<!--(pipe between link and label, i.e. [[:link|label]])
+ -->}}<!--
+ -->{{#if:{{{braceinside|}}} |<nowiki>{</nowiki>}}<!--
+ label / template name:
+ -->{{{alttext|{{#if:{{{1|}}}|{{{1}}}|{{#ifeq:{{NAMESPACE}}|{{ns:Template}}|{{PAGENAME}}|{{FULLPAGENAME}}}}}}}}}<!--
+ -->{{#if:{{{braceinside|}}} |<nowiki>}</nowiki>}}<!--
+ -->{{#if:{{{nolink|}}} | |<!--
+       -->{{!))}}<!--(end link)
+    -->{{#if:{{{braceinside|}}} |<nowiki>}</nowiki>}}<!--
+ -->}}<!--
+ -->{{#if:{{{bold|{{{boldlink|{{{boldname|}}}}}}}}} |'''}}<!--
-copy of {{tl|tlb}} except that it uses a non-proportional, monospaced font instead of normal text:
+ -->{{#if:{{{italic|{{{italics|}}}}}} |<span style="font-style:italic;">}}<!--
-{| class="wikitable"
+ -->{{#ifeq:{{{2|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{2}}}}}}}<!--
-! Code
+ -->{{#ifeq:{{{3|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{3}}}}}}}<!--
-! Result
+ -->{{#ifeq:{{{4|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{4}}}}}}}<!--
-! Remark
+ -->{{#ifeq:{{{5|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{5}}}}}}}<!--
-|-
+ -->{{#ifeq:{{{6|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{6}}}}}}}<!--
-| <code><nowiki>{{tlxb|Template name}}</nowiki></code>
+ -->{{#ifeq:{{{7|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{7}}}}}}}<!--
-| {{tlxb|Template name}}
+ -->{{#ifeq:{{{8|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{8}}}}}}}<!--
-|
+ -->{{#ifeq:{{{9|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{9}}}}}}}<!--
-|-
+ -->{{#ifeq:{{{10|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{10}}}}}}}<!--
-| <code><nowiki>{{tlxb|Template name|parameter1|parameter2}}</nowiki></code>
+  -->{{#ifeq:{{{11|¬}}}|¬ | |&#124;{{#tag:nowiki|{{{11}}}}}}}<!--
-| {{tlxb|Template name|parameter1|parameter2}}
+ -->{{#if:{{{12|}}} |&#124;…}}<!--
-|
+ -->{{#if:{{{italic|{{{italics|}}}}}} |</span>}}<!--
-|-
-| <code><nowiki>{{tlxb|Template name|parm1|parm2{{=}}foo}}</nowiki></code>
-| {{tlxb|Template name|parm1|parm2{{=}}foo}}
-| Equal signs need to be escaped using <code><nowiki>{{=}}</nowiki></code>.
-|-
-| <code><nowiki>{{tlxb}}</nowiki></code>
-| {{tlxb}}
-| This actually substitutes the current page name.  Useful as a self-reference; won't be linked.
-|-
-| <code><nowiki>{{tlxb|SISTER=m:|3x}}</nowiki></code>
-| {{tlxb|SISTER=m:|3x}}
-| Link to page on another wiki.
-|}
-I.e., it's a {{tl|tl}}-style ''template-link'' tag that boldfaces the template name, and accepts parameters. It's main use is in distinguishing between multiple templates with similar names, in documentation, talk page discussions, etc.
+ -->{{#if:{{{braceinside|}}} | |<nowiki>}}</nowiki>}}<!--
+ -->{{#if:{{{code|{{{tt|}}}}}}{{{plaincode|}}} |</code>}}<!--
-The rest of the documentation is for {{tl|tlx}}, which works the same way (although it doesn't currently behave sanely when no parameters are given; use {{tl|tlu}} instead).
+ -->{{#if:{{{nowrap|}}} |</span>}}<!--
+--></includeonly><noinclude>
-{{Documentation|Template:Tlx/doc}}
+{{Dokumentation|Dokumentation Links auf Vorlagen}}
-<!-- Add categories and interwikis to the /doc subpage, not here! -->
+<!-- Kategorien bitte an das Ende der UNterseite /Doku, Interwiki-Links bitte nach Wikidata -->
 </noinclude>