Changes
Jump to navigation
Jump to search
m
Robot - Speedily moving category Template-related templates to Category:Template namespace templates per CFDS.
{{Documentation subpage}}
{{#switch:{{PAGENAME}}
| Tlc = {{high-risk|493724}}
| Tld = {{high-use|107581}}
| #default=
}}
This page provides documentation for {{tl|tlc}} and {{tl|tld}}.
== Purpose and naming ==
When a template name with braces is to be shown in documentation, the braces have to be escaped in some way so it doesn't become an actual call to the template. Instead of using <code><nowiki></nowiki></code> tags you can write it more simply and concisely by using the {{tlc|tlc}} or {{tlc|tld}} templates.
These templates work similarly to {{tlc|tl}} and {{tlc|tlx}}, but don't make the template name into a link. When writing documentation you might want to avoid a lot of unnecessary links, since they can decrease readability. So on the first occurrence of a template name use {{tlx|tl}} or {{tlx|tlx}}, and then use {{tlc|tlc}} or {{tlc|tld}} thereafter.
{| class="wikitable"
|-
! Template
! style="width:15em;"|[[Wikt:mnemonic|Mnemonic]]
! Format differentiation
|-
| {{tlc|tlc}}
| '''T'''emplate '''l'''ink '''c'''ode
|rowspan=2 |Uses the <code><nowiki><code>...</code></nowiki></code> tags meant for showing programming code. Essentially the non-linking equivalent of {{tlx|tlx}}.
|-
| {{tlc|tld}}
| '''T'''emplate '''l'''ink '''d'''ialup-host
|}
The names were based on {{tlx|tl}} '''t'''emplate '''l'''ink, despite the fact that, unlike the actual {{tlc|tl}} template, these templates don't include an actual link. The mnemonics for {{tlc|tld}} and {{tlc|tlf}} were invented after the fact, since the template creator used the single letters still available rather than the preferred {{tlc|tlt}} (using <nowiki><tt></nowiki>) and {{tlc|tln}} (using "normal", non-coded text style) monikers.
===Basic operation===
Here is how these templates look. Code is to the left; actual rendering to the right:
:{{tlc|tlc|name|parameters}} = {{tlc|name|parameters}}
:{{tlc|tld|name|parameters}} = {{tld|name|parameters}}
===Use with editprotected templates===
Most Wikipedia users and even editors will have little or no need for use (or knowledge) of these templates. You will find them of more use if you are a writer or documenter of templates. However, editors may be pointed here when attempting to deal with edit requests on pages which have been [[Wikipedia:Protection policy|protected]] in some way.
Pages which have been protected can't be edited by every user, but would-be editors can request specific changes on the corresponding [[WP:Talk page|Discussion page]]. An editor requesting a change to a semi-protected page, for example, would add the {{tl|editsemiprotected}} template, followed by their request, to the Talk page. The {{tlc|editsemiprotected}} template expands to a texty notice which includes the instruction "Replace the {{tlc|editsemiprotected}} template with {{tlc|tlf|editsemiprotected}} when the request has been accepted or rejected." An empowered editor acting on the request would then change the template per this instruction.
The desired effect is to replace the {{tlc|editsemiprotected}} template (with its big, eye-catching box of information) by the ''name'' of the template, merely showing that the template had been there, and acted upon. The use of the {{tlc|tlf}} template means that the template should appear in a normal, proportional font-face, as in "{{tlf|editsemiprotected}}".
==Documentation==
===Functional details===
* This template takes another ''template-name'' and some associated [[Help:Pipe trick|pipe-tricked]] [[m:Parameter#Parameters|(numbered) parameters]] (or 'pass parameters'), and displays them as an 'example demonstration' of how the ''template-name'' template could be coded, literally. Its primary use is in instruction and documentation.
*Specifics here??? <!-- Coding details, other parameters (SUBST?), other notes? Cf. [[Template:Tlx]]. -->
*Features of {{tlc|tlc}} and {{tlc|tld}}:
** They show a template name and up to eight parameters (tlc) or ten parameters (tld).
** They also show empty parameters. (See examples hereafter.)
** They prevent [[line wrap]]s in their output.
===Usage===
{{tlc|Tlc|Template|first_parameter|second|third|...|eighth}} → {{Tlc|Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth}}
{{tlc|Tld|Template|first_parameter|second|third|...|tenth}} → {{Tld|Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth}}
=== Examples ===
Note: A different background color was used in the following table to make the "<code>code colouring</code>" visible.
{| class="wikitable" style="background-color: #FFEFD5;"
! Code !! Result !! Comment
|-
| {{tlc|tlc}} || {{tlc}} || Shows its own syntax.
|- style="background-color: #FFEBCD;"
| {{tld|tld}} || {{tld}} ||
|-
| {{tlc|tlc|name}} || {{tlc|name}} ||
|- style="background-color: #FFEBCD;"
| {{tld|tld|name}} || {{tld|name}} ||
|-
| {{tlc|tlc|name|one}} || {{tlc|name|one}} ||
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|one}} || {{tld|name|one}} ||
|-
| {{tlc|tlc|name|one|two}} || {{tlc|name|one|two}} ||
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|one|two}} || {{tld|name|one|two}} ||
|-
| <code><nowiki>{{tlc|name|a|b|c|d|e|f|g|h|i|j}}</nowiki></code> || {{tlc|name|a|b|c|d|e|f|g|h|i|j}} || Shows up to eight parameters. The rest are dropped.
|- style="background-color: #FFEBCD;"
| <code><nowiki>{{tld|name|a|b|c|d|e|f|g|h|i|j|k|l}}</nowiki></code> || {{tld|name|a|b|c|d|e|f|g|h|i|j|k|l}} || Shows up to ten parameters. The rest are replaced by an [[ellipsis]].
|-
| {{tlc|tlc|name|||three|four}} || {{tlc|name|||three|four}} || Also shows empty parameters.
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|||three|four}} || {{tld|name|||three|four}} ||
|-
| {{tlc|tlc|name|||three||}} || {{tlc|name|||three||}} || Even shows empty parameters that come in the end.
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|||three||}} || {{tld|name|||three||}} ||
|-
| {{tlc|tlc|name|one{{=}}a|two{{=}}b}} || {{tlc|name|one=a|two=b}} || The use of equal signs is a problem, but there is a fix; see next row.
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|one{{=}}a|two{{=}}b}} || {{tld|name|one=a|two=b}} ||
|-
| {{tlc|tlc|name|one{{((}}{{=}}{{))}}a|two{{((}}{{=}}{{))}}b}} || {{tlc|name|one{{=}}a|two{{=}}b}} || Use <code><nowiki>{{=}}</nowiki></code> in place of an equal sign, so that it gets rendered properly.
|- style="background-color:#FFEBCD"
| {{tld|tld|name|one{{((}}{{=}}{{))}}a|two{{((}}{{=}}{{))}}b}} || {{tld|name|one{{=}}a|two{{=}}b}} ||
|-
| {{tlc|tlc|name|{{tlf|IPA|/tʃ/}}|two}} || {{tlc|tlc|name|{{IPA|/tʃ/}}|two}} || Nested template calls also cause problems ...
|-
| <code><nowiki>{{tlc|name|{{tlf|IPA|/tʃ/}}|two}}</nowiki></code> || {{tlc|tlc|name|{{tlf|IPA|/tʃ/}}|two}} || ... but there are ways to get around this issue, also.
|-
| <code><nowiki>{{tlc|name|{{((}}IPA{{!}}/tʃ/{{))}}|two}}</nowiki></code> || {{tlc|tlc|name|{{tlf|IPA|/tʃ/}}|two}} || ... another way to do the same thing, using <code><nowiki>{{((}}</nowiki></code>, <code><nowiki>{{!}}</nowiki></code> and <code><nowiki>{{))}}</nowiki></code> to insert literal <code><nowiki>{{</nowiki></code>, <code><nowiki>|</nowiki></code> and <code><nowiki>}}</nowiki></code>, respectively.
|}
An alternative to using constructs such as <code><nowiki>{{=}}</nowiki></code> and <code><nowiki>{{tlf|...}}</nowiki></code> to prevent characters from getting interpreted syntactically is to use <code><nowiki><code><nowiki>...</nowiki></code></nowiki></code>, which will prevent '''all''' characters from being interpreted. For example, in place of
<code><nowiki>{{tlc|name|one{{=}}{{tlf|IPA|/tʃ/}}|two}}</nowiki></code>
you can use
<code><nowiki><code><nowiki>{{name|one={{IPA|/tʃ/}}|two}}</nowiki></code></nowiki></code>
Both render as
<code><nowiki>{{name|one={{IPA|/tʃ/}}|two}}</nowiki></code>
If a vertical display with parameters on their own lines is desired, this can also be laid out manually in this manner, or more rapidly done with <code><nowiki><pre>...</pre></nowiki></code>.
Here are the codes to emulate {{tlc|tlc}} and {{tld|tld}} using <code><nowiki></code>:
{|
! Using templates: !! Using <code><nowiki></code>: !! Rendered result:
|-
|style="padding-right: 50px;"| <code><nowiki>{{tlc|name|one{{=}}a|two{{=}}b}}</nowiki></code>
|style="padding-right: 50px;"| <code><nowiki><code><nowiki>{{name|one=a|two=b}}</nowiki></code></nowiki></code>
|<code><nowiki>{{name|one=a|two=b}}</nowiki></code>
|-
|style="padding-right: 50px;"| <code><nowiki>{{tld|name|one{{=}}a|two{{=}}b}}</nowiki></code>
|style="padding-right: 50px;"| <code><nowiki><code><nowiki>{{name|one=a|two=b}}</nowiki></code></nowiki></code>
|<code><nowiki>{{name|one=a|two=b}}</nowiki></code>
|}
===Limitations===
As documented at [[Help:Template#Problems and workarounds]], template arguments starting with one of the four MediaWiki magic characters <code>:</code> <code>;</code> <code>*</code> or <code>#</code> are interpreted ''as if'' they were at the beginning of a line, and are formatted as HTML lists. To avoid this, references to {{tlc|<nowiki/>*}} or {{tlc|#expr}} must have the first character escaped. You can either use {{tag|nowiki|s}} or an escape like <code>&#35;</code>.
===See also===
{{Template-linking templates}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- ADD CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Template namespace templates]] <!--but not e.g. Category:Internal template-link templates, as these templates do not include links to templates-->
[[Category:Typing-aid templates]]
}}</includeonly>
{{#switch:{{PAGENAME}}
| Tlc = {{high-risk|493724}}
| Tld = {{high-use|107581}}
| #default=
}}
This page provides documentation for {{tl|tlc}} and {{tl|tld}}.
== Purpose and naming ==
When a template name with braces is to be shown in documentation, the braces have to be escaped in some way so it doesn't become an actual call to the template. Instead of using <code><nowiki></nowiki></code> tags you can write it more simply and concisely by using the {{tlc|tlc}} or {{tlc|tld}} templates.
These templates work similarly to {{tlc|tl}} and {{tlc|tlx}}, but don't make the template name into a link. When writing documentation you might want to avoid a lot of unnecessary links, since they can decrease readability. So on the first occurrence of a template name use {{tlx|tl}} or {{tlx|tlx}}, and then use {{tlc|tlc}} or {{tlc|tld}} thereafter.
{| class="wikitable"
|-
! Template
! style="width:15em;"|[[Wikt:mnemonic|Mnemonic]]
! Format differentiation
|-
| {{tlc|tlc}}
| '''T'''emplate '''l'''ink '''c'''ode
|rowspan=2 |Uses the <code><nowiki><code>...</code></nowiki></code> tags meant for showing programming code. Essentially the non-linking equivalent of {{tlx|tlx}}.
|-
| {{tlc|tld}}
| '''T'''emplate '''l'''ink '''d'''ialup-host
|}
The names were based on {{tlx|tl}} '''t'''emplate '''l'''ink, despite the fact that, unlike the actual {{tlc|tl}} template, these templates don't include an actual link. The mnemonics for {{tlc|tld}} and {{tlc|tlf}} were invented after the fact, since the template creator used the single letters still available rather than the preferred {{tlc|tlt}} (using <nowiki><tt></nowiki>) and {{tlc|tln}} (using "normal", non-coded text style) monikers.
===Basic operation===
Here is how these templates look. Code is to the left; actual rendering to the right:
:{{tlc|tlc|name|parameters}} = {{tlc|name|parameters}}
:{{tlc|tld|name|parameters}} = {{tld|name|parameters}}
===Use with editprotected templates===
Most Wikipedia users and even editors will have little or no need for use (or knowledge) of these templates. You will find them of more use if you are a writer or documenter of templates. However, editors may be pointed here when attempting to deal with edit requests on pages which have been [[Wikipedia:Protection policy|protected]] in some way.
Pages which have been protected can't be edited by every user, but would-be editors can request specific changes on the corresponding [[WP:Talk page|Discussion page]]. An editor requesting a change to a semi-protected page, for example, would add the {{tl|editsemiprotected}} template, followed by their request, to the Talk page. The {{tlc|editsemiprotected}} template expands to a texty notice which includes the instruction "Replace the {{tlc|editsemiprotected}} template with {{tlc|tlf|editsemiprotected}} when the request has been accepted or rejected." An empowered editor acting on the request would then change the template per this instruction.
The desired effect is to replace the {{tlc|editsemiprotected}} template (with its big, eye-catching box of information) by the ''name'' of the template, merely showing that the template had been there, and acted upon. The use of the {{tlc|tlf}} template means that the template should appear in a normal, proportional font-face, as in "{{tlf|editsemiprotected}}".
==Documentation==
===Functional details===
* This template takes another ''template-name'' and some associated [[Help:Pipe trick|pipe-tricked]] [[m:Parameter#Parameters|(numbered) parameters]] (or 'pass parameters'), and displays them as an 'example demonstration' of how the ''template-name'' template could be coded, literally. Its primary use is in instruction and documentation.
*Specifics here??? <!-- Coding details, other parameters (SUBST?), other notes? Cf. [[Template:Tlx]]. -->
*Features of {{tlc|tlc}} and {{tlc|tld}}:
** They show a template name and up to eight parameters (tlc) or ten parameters (tld).
** They also show empty parameters. (See examples hereafter.)
** They prevent [[line wrap]]s in their output.
===Usage===
{{tlc|Tlc|Template|first_parameter|second|third|...|eighth}} → {{Tlc|Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth}}
{{tlc|Tld|Template|first_parameter|second|third|...|tenth}} → {{Tld|Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth}}
=== Examples ===
Note: A different background color was used in the following table to make the "<code>code colouring</code>" visible.
{| class="wikitable" style="background-color: #FFEFD5;"
! Code !! Result !! Comment
|-
| {{tlc|tlc}} || {{tlc}} || Shows its own syntax.
|- style="background-color: #FFEBCD;"
| {{tld|tld}} || {{tld}} ||
|-
| {{tlc|tlc|name}} || {{tlc|name}} ||
|- style="background-color: #FFEBCD;"
| {{tld|tld|name}} || {{tld|name}} ||
|-
| {{tlc|tlc|name|one}} || {{tlc|name|one}} ||
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|one}} || {{tld|name|one}} ||
|-
| {{tlc|tlc|name|one|two}} || {{tlc|name|one|two}} ||
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|one|two}} || {{tld|name|one|two}} ||
|-
| <code><nowiki>{{tlc|name|a|b|c|d|e|f|g|h|i|j}}</nowiki></code> || {{tlc|name|a|b|c|d|e|f|g|h|i|j}} || Shows up to eight parameters. The rest are dropped.
|- style="background-color: #FFEBCD;"
| <code><nowiki>{{tld|name|a|b|c|d|e|f|g|h|i|j|k|l}}</nowiki></code> || {{tld|name|a|b|c|d|e|f|g|h|i|j|k|l}} || Shows up to ten parameters. The rest are replaced by an [[ellipsis]].
|-
| {{tlc|tlc|name|||three|four}} || {{tlc|name|||three|four}} || Also shows empty parameters.
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|||three|four}} || {{tld|name|||three|four}} ||
|-
| {{tlc|tlc|name|||three||}} || {{tlc|name|||three||}} || Even shows empty parameters that come in the end.
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|||three||}} || {{tld|name|||three||}} ||
|-
| {{tlc|tlc|name|one{{=}}a|two{{=}}b}} || {{tlc|name|one=a|two=b}} || The use of equal signs is a problem, but there is a fix; see next row.
|- style="background-color: #FFEBCD;"
| {{tld|tld|name|one{{=}}a|two{{=}}b}} || {{tld|name|one=a|two=b}} ||
|-
| {{tlc|tlc|name|one{{((}}{{=}}{{))}}a|two{{((}}{{=}}{{))}}b}} || {{tlc|name|one{{=}}a|two{{=}}b}} || Use <code><nowiki>{{=}}</nowiki></code> in place of an equal sign, so that it gets rendered properly.
|- style="background-color:#FFEBCD"
| {{tld|tld|name|one{{((}}{{=}}{{))}}a|two{{((}}{{=}}{{))}}b}} || {{tld|name|one{{=}}a|two{{=}}b}} ||
|-
| {{tlc|tlc|name|{{tlf|IPA|/tʃ/}}|two}} || {{tlc|tlc|name|{{IPA|/tʃ/}}|two}} || Nested template calls also cause problems ...
|-
| <code><nowiki>{{tlc|name|{{tlf|IPA|/tʃ/}}|two}}</nowiki></code> || {{tlc|tlc|name|{{tlf|IPA|/tʃ/}}|two}} || ... but there are ways to get around this issue, also.
|-
| <code><nowiki>{{tlc|name|{{((}}IPA{{!}}/tʃ/{{))}}|two}}</nowiki></code> || {{tlc|tlc|name|{{tlf|IPA|/tʃ/}}|two}} || ... another way to do the same thing, using <code><nowiki>{{((}}</nowiki></code>, <code><nowiki>{{!}}</nowiki></code> and <code><nowiki>{{))}}</nowiki></code> to insert literal <code><nowiki>{{</nowiki></code>, <code><nowiki>|</nowiki></code> and <code><nowiki>}}</nowiki></code>, respectively.
|}
An alternative to using constructs such as <code><nowiki>{{=}}</nowiki></code> and <code><nowiki>{{tlf|...}}</nowiki></code> to prevent characters from getting interpreted syntactically is to use <code><nowiki><code><nowiki>...</nowiki></code></nowiki></code>, which will prevent '''all''' characters from being interpreted. For example, in place of
<code><nowiki>{{tlc|name|one{{=}}{{tlf|IPA|/tʃ/}}|two}}</nowiki></code>
you can use
<code><nowiki><code><nowiki>{{name|one={{IPA|/tʃ/}}|two}}</nowiki></code></nowiki></code>
Both render as
<code><nowiki>{{name|one={{IPA|/tʃ/}}|two}}</nowiki></code>
If a vertical display with parameters on their own lines is desired, this can also be laid out manually in this manner, or more rapidly done with <code><nowiki><pre>...</pre></nowiki></code>.
Here are the codes to emulate {{tlc|tlc}} and {{tld|tld}} using <code><nowiki></code>:
{|
! Using templates: !! Using <code><nowiki></code>: !! Rendered result:
|-
|style="padding-right: 50px;"| <code><nowiki>{{tlc|name|one{{=}}a|two{{=}}b}}</nowiki></code>
|style="padding-right: 50px;"| <code><nowiki><code><nowiki>{{name|one=a|two=b}}</nowiki></code></nowiki></code>
|<code><nowiki>{{name|one=a|two=b}}</nowiki></code>
|-
|style="padding-right: 50px;"| <code><nowiki>{{tld|name|one{{=}}a|two{{=}}b}}</nowiki></code>
|style="padding-right: 50px;"| <code><nowiki><code><nowiki>{{name|one=a|two=b}}</nowiki></code></nowiki></code>
|<code><nowiki>{{name|one=a|two=b}}</nowiki></code>
|}
===Limitations===
As documented at [[Help:Template#Problems and workarounds]], template arguments starting with one of the four MediaWiki magic characters <code>:</code> <code>;</code> <code>*</code> or <code>#</code> are interpreted ''as if'' they were at the beginning of a line, and are formatted as HTML lists. To avoid this, references to {{tlc|<nowiki/>*}} or {{tlc|#expr}} must have the first character escaped. You can either use {{tag|nowiki|s}} or an escape like <code>&#35;</code>.
===See also===
{{Template-linking templates}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- ADD CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Template namespace templates]] <!--but not e.g. Category:Internal template-link templates, as these templates do not include links to templates-->
[[Category:Typing-aid templates]]
}}</includeonly>
