Template:Tlc

{{tlc|...}}

Template documentation[view] [edit] [history] [purge]

This page provides documentation for {{tlc}} and {{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 <nowiki></nowiki> tags you can write it more simply and concisely by using the ‹The template Tlc is being considered for merging.› {{tlc}} or ‹The template Tlc is being considered for merging.› {{tld}} templates.

These templates work similarly to ‹The template Tlc is being considered for merging.› {{tl}} and ‹The template Tlc is being considered for merging.› {{tlx}}, but don't make the template name into a link (template link cleared). 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 {{tl}} or {{tlx}}, and then use ‹The template Tlc is being considered for merging.› {{tlc}} or ‹The template Tlc is being considered for merging.› {{tld}} thereafter.

Template	Mnemonic	Format differentiation
‹The template Tlc is being considered for merging.› {{tlc}}	Template link code	Uses the <code>...</code> tags meant for showing programming code. Essentially the non-linking equivalent of {{tlx}}.
‹The template Tlc is being considered for merging.› {{tld}}	Template link dialup-host

The names were based on {{tl}} template link, despite the fact that, unlike the actual ‹The template Tlc is being considered for merging.› {{tl}} template, these templates don't include an actual link.

Basic operation

Here is how these templates look. Code is to the left; actual rendering to the right:

‹The template Tlc is being considered for merging.› {{tlc|name|parameters}} → ‹The template Tlc is being considered for merging.› {{name|parameters}}

‹The template Tlc is being considered for merging.› {{tld|name|parameters}} → {{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 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 Discussion page. An editor requesting a change to a semi-protected page, for example, would add the {{editsemiprotected}} template, followed by their request, to the Talk page. The ‹The template Tlc is being considered for merging.› {{editsemiprotected}} template expands to a texty notice which includes the instruction "Replace the ‹The template Tlc is being considered for merging.› {{editsemiprotected}} template with ‹The template Tlc is being considered for merging.› {{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 ‹The template Tlc is being considered for merging.› {{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 ‹The template Tlc is being considered for merging.› {{tlf}} template means that the template should appear in a normal, proportional font-face, as in "{{editsemiprotected}}".

Documentation

Functional details

• This template takes another template-name and some associated pipe-tricked (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???
• Features of ‹The template Tlc is being considered for merging.› {{tlc}} and ‹The template Tlc is being considered for merging.› {{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 wraps in their output.

Usage

‹The template Tlc is being considered for merging.› {{Tlc|Template|first_parameter|second|third|...|eighth}} → ‹The template Tlc is being considered for merging.› {{Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth}}

‹The template Tlc is being considered for merging.› {{Tld|Template|first_parameter|second|third|...|tenth}} → {{Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth}}

Examples

Code	Result	Comment
‹The template Tlc is being considered for merging.› {{tlc}}	‹The template Tlc is being considered for merging.› {{tlc|...}}	Shows its own syntax.
{{tld}}
‹The template Tlc is being considered for merging.› {{tlc|name}}	‹The template Tlc is being considered for merging.› {{name}}
{{tld|name}}	{{name}}
‹The template Tlc is being considered for merging.› {{tlc|name|one}}	‹The template Tlc is being considered for merging.› {{name|one}}
{{tld|name|one}}	{{name|one}}
‹The template Tlc is being considered for merging.› {{tlc|name|one|two}}	‹The template Tlc is being considered for merging.› {{name|one|two}}
{{tld|name|one|two}}	{{name|one|two}}
{{tlc|name|a|b|c|d|e|f|g|h|i|j}}	‹The template Tlc is being considered for merging.› {{name|a|b|c|d|e|f|g|h}}	Shows up to eight parameters. The rest are dropped.
{{tld|name|a|b|c|d|e|f|g|h|i|j|k|l}}	{{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.
‹The template Tlc is being considered for merging.› {{tlc|name|||three|four}}	‹The template Tlc is being considered for merging.› {{name|||three|four}}	Also shows empty parameters.
{{tld|name|three|four}}	{{name|three|four}}
‹The template Tlc is being considered for merging.› {{tlc|name|||three||}}	‹The template Tlc is being considered for merging.› {{name|||three||}}	Even shows empty parameters that come in the end.
{{tld|name|three}}	{{name|three}}
‹The template Tlc is being considered for merging.› {{tlc|name|one=a|two=b}}	‹The template Tlc is being considered for merging.› {{name}}	The use of equal signs is a problem, but there is a fix; see next row.
{{tld|name|one=a|two=b}}	{{name}}
‹The template Tlc is being considered for merging.› {{tlc|name|one{{=}}a|two{{=}}b}}	‹The template Tlc is being considered for merging.› {{name|one=a|two=b}}	Use {{=}} in place of an equal sign, so that it gets rendered properly.
{{tld|name|one{{=}}a|two{{=}}b}}	{{name|one=a|two=b}}
‹The template Tlc is being considered for merging.› {{tlc|name|{{IPA|/tʃ/}}|two}}	‹The template Tlc is being considered for merging.› {{tlc|name|/tʃ/|two}}	Nested template calls also cause problems ...
{{tlc|name|{{tlf|IPA|/tʃ/}}|two}}	‹The template Tlc is being considered for merging.› {{tlc|name|{{IPA|/tʃ/}}|two}}	... but there are ways to get around this issue, also.
{{tlc|name|{{((}}IPA{{!}}/tʃ/{{))}}|two}}	‹The template Tlc is being considered for merging.› {{tlc|name|{{IPA|/tʃ/}}|two}}	... another way to do the same thing, using {{((}}, {{!}} and {{))}} to insert literal {{, | and }}, respectively.

An alternative to using constructs such as {{=}} and {{tlf|...}} to prevent characters from getting interpreted syntactically is to use <code><nowiki>...</nowiki></code>, which will prevent all characters from being interpreted. For example, in place of

{{tlc|name|one{{=}}{{tlf|IPA|/tʃ/}}|two}}

you can use

<code><nowiki>{{name|one={{IPA|/tʃ/}}|two}}</nowiki></code>

Both render as

{{name|one={{IPA|/tʃ/}}|two}}

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 <pre>...</pre>.

Here are the codes to emulate ‹The template Tlc is being considered for merging.› {{tlc}} and {{tld}} using <nowiki>:

Using templates:	Using <nowiki>:	Rendered result:
{{tlc|name|one{{=}}a|two{{=}}b}}	<code><nowiki>{{name|one=a|two=b}}</nowiki></code>	{{name|one=a|two=b}}
{{tld|name|one{{=}}a|two{{=}}b}}	<code><nowiki>{{name|one=a|two=b}}</nowiki></code>	{{name|one=a|two=b}}

Limitations

As documented at Help:Template#Problems and workarounds, template arguments starting with one of the four MediaWiki magic characters : ; * or # are interpreted as if they were at the beginning of a line, and are formatted as HTML lists. To avoid this, references to ‹The template Tlc is being considered for merging.› {{*}} or ‹The template Tlc is being considered for merging.› {{#expr}} must have the first character escaped. You can either use <nowiki /> or an escape like #.

See also

General-purpose formatting

Comparison of template-linking templates according to their style

	Link style →	Linked	Unlinked	Linked with subst	Linked including braces	Linked with alternative text
Text style ↓	↓ {{tlg}} options1 →	DEFAULT	<syntaxhighlight lang="text" class="" id="" style="" inline="1">nolink=yes</syntaxhighlight>	<syntaxhighlight lang="text" class="" id="" style="" inline="1">subst=yes</syntaxhighlight>	<syntaxhighlight lang="text" class="" id="" style="" inline="1">braceinside=yes</syntaxhighlight>	<syntaxhighlight lang="text" class="" id="" style="" inline="1">alttext=Foo</syntaxhighlight> <syntaxhighlight lang="text" class="" id="" style="" inline="1">2=Foo</syntaxhighlight>
normal	DEFAULT	{{tlg}}1 {{tl}} {{tlp|1|2|...}}2 {{Template:tlu}}3	{{tlf}}2	{{subst:tls}} {{subst:tlsp|1|2|...}} {{subst:Template:tlsu}}3	{{tn}}	{{tla}}
code	<syntaxhighlight lang="text" class="" id="" style="" inline="1">code=yes</syntaxhighlight>	{{tl2}} {{tlx}} {{Template:tlxu}}3	‹The template Tlc is being considered for merging.› {{tlc}}2 {{tld}}2 {{tnull}}	{{subst:tlxs}}	N/A
monospace kbd	<syntaxhighlight lang="text" class="" id="" style="" inline="1">plaincode=yes</syntaxhighlight>4 <syntaxhighlight lang="text" class="" id="" style="" inline="1">kbd=yes</syntaxhighlight>5	N/A		{{subst:tltss}}5
bold	<syntaxhighlight lang="text" class="" id="" style="" inline="1">bold=yes</syntaxhighlight>	{{tlb}}	N/A
bold+code	code=yes</syntaxhighlight>	{{tlxb}}
italic+code	code=yes</syntaxhighlight>	{{tlxi}}
1  {{tlg}} is the most general, allowing any combination of text style and/or link style options. 2  Prevents wrapping of text by placing it inside <span class="nowrap">...</span> tags. 3  Allows links to templates in any namespace. 4  {{tlg|plaincode=yes}} uses <code style="border:none; background-color:transparent;">...</code>. 5  Displays monospaced font using <span style="font-family:monospace;">...</span>.

Other formatting templates

Code example	Effect	Notes
{{tl2|Hatnote|lang=fr}}	{{hatnote}}	Supports linking to sister projects (e.g., fr:Hatnote)
{{tlu|User:Ahunt/SSHFS}}	{{User:Ahunt/SSHFS}}	Supports linking to any namespace
{{demo|<nowiki>{{Hatnote|lang=fr|Some text}}</nowiki>}}	{{hatnote|lang=fr|Some text}} Some text	Shows code and example
{{xpd|Hatnote|Some hatnote text}}	"{{hatnote|Some hatnote text}}" gives " Some hatnote text " [1]	Shows code, example and a link to expand the template code
{{tln|Hatnote}}	Template:Hatnote	Produces a normal link to the template
{{elc|Template:Hatnote}} {{elc|Template:Hatnote|Hatnote}}	[[Template:Hatnote]] [[Template:Hatnote|Hatnote]]	Formats wikilink, with optional piped link text and blended suffix
{{ml|Example|hello}}	{{#invoke:Example|hello}}	Counterpart to {{tl}} for linking to Lua modules
{{mlx|Example|hello}}	{{#invoke:Example|hello}}	Counterpart to {{tlx}} for linking to Lua modules
{{para|title|<var>book title</var>}}	|title=book title	Formats template parameters for display, with or without values
{{sclx|LASTING}}	[[WP:LASTING]]	Takes a shortcut suffix in project namespace and displays it with brackets and the WP: alias in a <code>...</code> tag.
{{tag|ref}} {{xtag|templatedata}}	<ref>...</ref> <templatedata>	Formats [X]HTML tags; can add content, choose opening, closing, or self-closing
{{dtl|Ping project}}	{{d:Ping project}}	Wikidata counterpart to {{tl}}
{{pf|if}} {{pf|if|{{{1}}}|true|false}}	{{#if}} {{#if:{{{1}}}|true|false}}	Parser function equivalent to {{tl}}

With utility links

Code example	Effect
{{lt|Hatnote}}	Template:Hatnote (edit | talk | history | links | watch | logs)
{{lts|Hatnote}}	Template:Hatnote(edit talk links history)
{{t links|Hatnote}}	Hatnote (edit talk history links # /subpages /doc /doc edit /sbox /sbox diff /test)
{{tfd links|Hatnote}}	Template:Hatnote (edit · talk · history · links · transclusions · logs · subpages · delete)
{{tltt|Hatnote}}	{{Hatnote}}
{{tetl|Hatnote}}	{{Hatnote}} links talk edit
{{tsetl|Hatnote}}	{{subst:Hatnote}}  links talk edit
{{ti|Hatnote}}	Template:Hatnote (talk⧼dot-separator⧽links⧼dot-separator⧽edit)
{{tic|Hatnote}}	Template:Hatnote (talk links edit)
{{tim|Hatnote}}	m:Template:Hatnote (backlinks edit)
{{tiw|Hatnote}}	Template:Hatnote (backlinks edit)
{{tlt|Hatnote}}	{{Hatnote}} (talk)
{{ttl|Hatnote}}	{{Hatnote}} (t/l)
{{twlh|Hatnote}}	Template:Hatnote (links, talk)

The above documentation is transcluded from Template:Tlc/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.