|
|
| (169 intermediate revisions by more than 100 users not shown) |
| Line 1: |
Line 1: |
| {{Documentation subpage}} | | {{Documentation subpage}} |
| <includeonly>{{high-risk| 880,000+ }}</includeonly>
| | <!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). --> |
| <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> | | The '''template link''' (or "tl") template is a simple [[w:Macro (computer science)|macro]] [[m:Help:template|template]] used to display a template name as a link surrounded by braces, thus showing the template name as code rather than actually invoking it. Its primary use is in instruction and documentation where it is used to refer to a template by name without invoking it. |
| __NOTOC__
| |
|
| |
|
| The '''template link''' template is a simple [[w:Macro (computer science)|macro]] [[m:Help:template|template]] used to display a template name as a link surrounded by braces, thus showing how the template name would be used in code. Its primary use is in instruction and documentation. A short example is that the code:
| | ==Examples== |
| | An example of its use is: |
|
| |
|
| ::<code><nowiki>{{tl|example}}</nowiki></code> | | ::<code><nowiki>{{tl|Example}}</nowiki></code> |
| | :which generates |
| | ::{{tl|Example}} |
|
| |
|
| :generates
| |
|
| |
|
| ::{{tl|example}} | | == TemplateData == |
| | <templatedata>{ |
| | "description": "This template displays a template name as a link surrounded by braces, thus showing how the template name would be used in code. Its primary use is in instruction and documentation.", |
| | "params": { |
| | "1": { |
| | "label": "template name", |
| | "description": "positional parameter: the template name without the namespace prefix “Template:”, which is added automatically", |
| | "type": "wiki-template-name", |
| | "required": true |
| | } |
| | } |
| | }</templatedata> |
|
| |
|
| More complex variations are described below.
| | == See also == |
|
| | * {{tl|tlx}} to produce a [t]emplate [l]ink with an e[x]panded number of parameters. |
| === Related templates === | | <includeonly>[[Category:link templates]]</includeonly> |
| | |
| {{tl2|tl2}} differs in that it displays an arguably clearer result like {{tlx|tlx}}, and also takes the named parameters 'SISTER=xx' and 'LANG=ll', so that it may also be used to ''list and link to templates on other English and non-English language sister projects''.
| |
|
| |
| {{tlx|tlx}} displays with the same enhanced presentation, and also expands several 'placeholder' parameters to generate a sample template call. | |
| | |
| === Usage ===
| |
| | |
| <pre>
| |
| {{Tl|template name to display}}
| |
| and
| |
| {{Tl2|template name to display}} -- local link, just like Tl.
| |
| or
| |
| {{Tl2|SISTER=V:|template name to display}} -- displays a template on Wikiversity
| |
| or
| |
| {{Tl2|LANG=fr.|SISTER=wikisource|template name to display}} -- displays a template
| |
| on the French Wikisource sister project.
| |
| </pre>
| |
| | |
| === Example ===
| |
| | |
| {| class="wikitable"
| |
| ! Code
| |
| ! Result
| |
| |-
| |
| | <code><nowiki>{{Tl|x0}}</nowiki></code>
| |
| | {{[[Template:X0|x0]]}}
| |
| |-
| |
| | <code><nowiki>{{Tl2|x1}}</nowiki></code>
| |
| | <tt><nowiki>{{</nowiki>[[{{{LANG|}}}{{{SISTER|}}}{{ns:Template}}:x1|x1]]<nowiki>}}</nowiki></tt>
| |
| |-
| |
| | <code><nowiki>{{Tl2|SISTER=M:|3x}}</nowiki></code>
| |
| | <tt><nowiki>{{</nowiki>[[{{{LANG|}}}M:{{ns:Template}}:3x|3x]]<nowiki>}}</nowiki></tt>
| |
| |-
| |
| | <code><nowiki>{{Tl2|SISTER=wikibooks|LANG=de:|WP}}</nowiki></code>
| |
| | <tt><nowiki>{{</nowiki>[http://de.wikibooks.org/wiki/Vorlage:WP WP]<nowiki>}}</nowiki></tt><!---
| |
| ----- This is currently a fraudulent output result... the template code needs modified to work
| |
| ----- per this plan, then this /doc file fixed up to match whatever the correct syntax actually is.
| |
| ----- ALMOST work:
| |
| [[:de:wikibooks:{{ns:template}}:WP |WP]]
| |
| [[de:wikibooks:{{ns:template}}:WP |WP]]
| |
| ---->
| |
| |}
| |
| | |
| === See also ===
| |
| | |
| * {{tl|tl2}} – Template link, up to three parameters and interwiki links.
| |
| * {{tl|tlp}} – Template link, with single parameter.
| |
| * {{tl|tlx}} – Template link, up to three parameters and interwiki links.
| |
| * {{tl|tlsp}} – Template link, ditto subst'ed.
| |
| * {{tl|lts}} – See Lts discussion for more variants.
| |
| * {{tl|tlu}} – Like {{tlx|tl}} / {{tlx|tlp}} for any namespace.
| |
| * {{tl|tn}} – Same as tl, but shows the braces as part of the link.
| |
| * {{tl|evd}} – Show live example
| |
| * {{tl|tlc}}, {{tl|tld}} and {{tl|tlf}} – Template names without links.
| |
| * [[:Category:Internal link templates]]
| |
| | |
| <includeonly> | |
| <!-- ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE -->
| |
| [[Category:Typing-aid templates|{{PAGENAME}}]] | |
| [[Category:Internal link templates|{{PAGENAME}}]]
| |
| | |
| [[ar:قالب:قا]]
| |
| [[az:Şablon:ŞK]]
| |
| [[be-x-old:Шаблён:Ш]]
| |
| [[bg:Шаблон:Ш]]
| |
| [[ca:Plantilla:Tl]]
| |
| [[cs:Šablona:Šablona]]
| |
| [[da:Skabelon:Vis]]
| |
| [[dsb:Pśedłoga:Pśedłoga]]
| |
| [[et:Mall:Malli näide]]
| |
| [[eo:Ŝablono:Ŝ]]
| |
| [[es:Plantilla:Template link]]
| |
| [[fa:الگو:الگوی]]
| |
| [[fi:Malline:Malline]]
| |
| [[fr:Modèle:M]]
| |
| [[got:Template:Tl]]
| |
| [[he:תבנית:תב]]
| |
| [[hsb:Předłoha:Předłoha]]
| |
| [[ia:Patrono:Tl]]
| |
| [[ja:Template:Tl]]
| |
| [[ka:თარგი:Tl]]
| |
| [[ko:틀:Tl]]
| |
| [[kw:Template:Viz]]
| |
| [[hu:Sablon:Sablonhivatkozás leírással]]
| |
| [[my:Template:Tl]]
| |
| [[or:Template:Tl]]
| |
| [[pa:ਨਮੂਨਾ:Tl]]
| |
| [[pih:Template:Tl]]
| |
| [[pl:Szablon:S]]
| |
| [[pnt:Πρότυπον:Πρότυπον]]
| |
| [[pt:Predefinição:Link para predefinição]]
| |
| [[ro:Format:F]]
| |
| [[ru:Шаблон:Tl]]
| |
| [[sl:Predloga:Tl]]
| |
| [[sv:Mall:Mall]]
| |
| [[th:แม่แบบ:Tl]]
| |
| [[tr:Şablon:Tl]]
| |
| [[uk:Шаблон:Tl]]
| |
| [[vi:Tiêu bản:Tl]]
| |
| [[zh:Template:Tl]]
| |
| [[zh-yue:Template:Tl]]
| |
| </includeonly> | |
Template:Documentation subpage
The template link (or "tl") template is a simple macro template used to display a template name as a link surrounded by braces, thus showing the template name as code rather than actually invoking it. Its primary use is in instruction and documentation where it is used to refer to a template by name without invoking it.
Examples
An example of its use is:
{{tl|Example}}
- which generates
- {{Example}}
TemplateData
Template parameters
| Parameter | Description | Type | Status |
|---|
| template name | 1 | positional parameter: the template name without the namespace prefix “Template:”, which is added automatically
| Template | required |
|---|
See also
- {{tlx}} to produce a [t]emplate [l]ink with an e[x]panded number of parameters.
