Template:Tlc

{{tlc|...}}

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:Tlc/doc.

This is the {{tlc}} template.

This page also serves as the full documentation for {{Tlf}} (doc page), that works almost exactly the same.

When showing a template name with brackets in documentation you have to escape the brackets in some way so it doesn't become a call to the template. Instead of using <nowiki></nowiki> tags you can write it simpler and shorter by using these templates.

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

{{tlc|name|parameters}} = {{name|parameters}}

{{tlf|name|parameters}} = {{name|parameters}}

These templates work similarly to {{Tl}} and {{tlx}}, but they don't make the template name into a link. When writing documentation you might want to avoid a lot of unnecessary links, since it decreases readability. So on the first occurrence of a template name use {{Tl}}, {{tld}} or {{tlx}}, and then use {{tlc}} or {{tlf}}.

Features of {{tlc}}, {{tld}}, {{tlf}} and {{tlp}}:

• They show a template name and up to eight parameters.
• They also show empty parameters. (See examples below.)
• They prevent line wraps in their output.

Examples

Wikitables make the <code></code> tags transparent, that's why the "code colouring" is missing in these examples.

Code	Result	Comment
{{tlc}}	{{{{{1}}}}}	Shows its own syntax.
{{tlc|name}}	{{name}}
{{tlc|name|one}}	{{name|one}}
{{tlc|name|one|two}}	{{name|one|two}}
{{tlc|name|a|b|c|d|e|f|g|h|i|j}}	{{name|a|b|c|d|e|f|g|h}}	Shows up to eight parameters. The rest are dropped.
{{tlc|name|||three|four}}	{{name|||three|four}}	Also shows empty parameters.
{{tlc|name|||three||}}	{{name|||three||}}	Even shows empty parameters that come in the end.
{{tlc|name|one=a|two=b}}	{{name}}	Equal signs is a problem, but there is a fix.
{{tlc|name|2=one=a|3=two=b}}	{{name|one=a|two=b}}	Use numbered parameters to fix it. Remember to start from 2, since the "name" is number 1.

If you have equal signs in your template parameters, you should replace them with {{=}}, but it probably is simpler and clearer to code it using <nowiki> tags etc. Here are the codes to emulate {{tlf}} and {{tlc}} respectively. Code to the left and actual rendering to the right:

• <span class="nowrap"><nowiki>{{name|one=a|two=b}}</nowiki></span> → {{name|one=a|two=b}}
• <code class="nowrap"><nowiki>{{name|one=a|two=b}}</nowiki></code> → {{name|one=a|two=b}}

TemplateData

 Parameter text is empty

<templatedata>JSON</templatedata> ./. {{TemplateBox}}

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

---

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

---

Wikipedia's help about TemplateData • Commons-specific information

Template link code

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Template	1	Linked template name	Template	required
Parameter 1	2	First parameter value	String	optional
Parameter 2	3	Second parameter value	String	optional
Parameter 3	4	Third parameter value	String	optional
Parameter 4	5	Fourth parameter value	String	optional
Parameter 5	6	Fifth parameter value	String	optional
Parameter 6	7	Sixth parameter value	String	optional
Parameter 7	8	Seventh parameter value	String	optional
Parameter 8	9	Eight parameter value	String	optional

Template links

List of templates using {{T/main}}

Code	Result	Notes	lock
{{T|example}}	{{Example}}	makes brackets part of the link
{{T0|example}}	Example	just link, without the brackets
{{T1|example}}	{{Example}}	inner brackets are part of the link
{{T2|example}}	{{Example}}	brackets are not a part of the link
{{Tl|example}}	{{Example}}	makes brackets around the link
{{Tlr|User:Example}}	{{User:Example}}	like {{tl}} but for any namespace
{{Tls|example}}	{{subst:example}}	no parameters, adds "subst:"
Templates showing parameters 0 Meta template {{Tle}} is easiest to parametrize.
{{Tle|T=F|p1=1|v1|p2=2|v2|p3=3|v3}}	{{ F | 1 = v1 | 2 = v2 | 3 = v3 }}	describes template parameters by names and values
{{Tlx|example|1|2|3|4|5||7|8|9}}	{{example|1|2|3|4|5|7|8|...}}	up to 8 parameters
{{Tlf|example|1|2|3|...up to 8}}	{{example|1|2|3|...up to 8}}	up to 8 parameters, no link
{{Tlc|example|1|2|3|4|||7|up to 8|9 is ignored.}}	{{example|1|2|3|4|||7|up to 8}}	up to 8 parameters, no link, <code> style
{{Tld|example|1|2||3||}}	{{example|1||2|3||}}	up to 8 parameters, <code> style[clarification needed]
{{Tlsu|User:Example}}	{{subst:User:Example}}	like {{Tls}}, but supporting parameters
Alternative forms 0 These ignore empty parameters.
{{Tlp|example|1|2|3|4|5||7|8|9 is ignored.}}	{{example|1|2|3|4|5|7|8}}	up to 8 parameters; ignores empty parms
{{Tl2|example|p1|p2}}	{{example|p1|p2}}	up to 2 parameters, <code> style
{{Tlsp|example|1|2|3|4|5|6|7|8|9}}	{{subst:example|1|2|3|4|5|6|7|8|...}}	up to 8 parameters, adds linked "subst:"
{{Tlsx|example|1|2|3|4|5|6 and above are ignored.|7}}	{{subst:example|1|2|3|4|5|...}}	up to 5 parameters, adds linked "subst:", <code> style

General-purpose formatting

Comparison of template-linking templates according to the styles of generated text and link produced

Text style ↓	{{tlg}} options to achieve text style	Link style
		Linked	Unlinked	Linked with subst	Unlinked with subst	Linked including braces
{{tlg}} options to achieve link style	N/A	DEFAULT	nolink=yes	subst=yes	nolink=yes|subst=yes	braceinside=yes
normal	DEFAULT	{{tlg}} {{T2}} {{tlx}} {{tlp|1|2|...}} {{Template:tlr}} {{Template:tlu}}	{{tlf}} <template link>	{{subst:tls}} {{subst:tlsp}} {{subst:Template:tlsu}}	N/A	{{T}}
code	code=yes	{{tl2}}	{{tlc}} <template link>	{{subst:tlsx}}	{{subst:tlsc}} <template link>	N/A
monospace	mono=yes	{{tld}}	N/A	{{subst:tltts}}	N/A	{{Tl}}
plaincode	plaincode=yes
kbd[clarification needed]	kbd=yes