Template:Tlc

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

{{tlc|...}}

Documentationview · 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 {{Tld}} (doc page) and {{Tlf}} (doc page), that work 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}}
{{tld|name|parameters}} = {{name|parameters}}
{{tlf|name|parameters}} = {{name|parameters}}

These templates work similarly to {{Tl}} and {{tlx}}, but (except for {{Tld}}) 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}} or {{tlx}}, and then use {{tlc}}, {{tld}} or {{tlf}}.

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

  • 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[edit]

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

CodeResultComment
{{tlc}} {{tlc|...}} 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}}, {{tld}} and {{tlc}} respectively. Code to the left and actual rendering to the right:

<nowiki>{{name|one=a|two=b}}</nowiki> = {{name|one=a|two=b}}
<tt><nowiki>{{name|one=a|two=b}}</nowiki></tt> = {{name|one=a|two=b}}
<code><nowiki>{{name|one=a|two=b}}</nowiki></code> = {{name|one=a|two=b}}

[edit subpage]

Template links[edit]

List of templates using {{T/main}}
Code Result Notes lock

{{T|example}}

{{Example}} makes brackets part of the link; see docu Lock-r.svg

{{T0|example}}

Example just link, without the brackets; see docu Lock-g.svg

{{T1|example}}

{{Example}} inner brackets are part of the link; see docu Lock-g.svg

{{T2|example}}

{{Example}} brackets are not a part of the link; see docu Lock-g.svg

{{Tl|example}}

{{Example}} makes brackets around the link; see docu Lock-r.svg

{{Tls|example}}

{{subst:example}} no parameters, adds "subst:" Lock-r.svg
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 }} decribes template parameters by names and values Lock-g.svg

{{Tlx|example|1|2|3|4|5||7|8|9}}

{{example|1|2|3|4|5|7|8|...}} up to 8 parameters Lock-r.svg

{{Tlf|example|1|2|3|...up to 8}}

{{example|1|2|3|...up to 8}} up to 8 parameters, no link; see docu Lock-r.svg

{{Tlc|example|1|2|3|4|||7|up to 8|9}}

{{example|1|2|3|4|||7|up to 8}} up to 8 parameters, no link, <code> style Lock-g.svg

{{Tld|example|1|2||3||}}

{{example|1||2|3||}} up to 8 parameters, <code> style; see docu Lock-g.svg

{{Tlr|User:Example}}

{{User:Example}} like {{tl}} but for any namespace Lock-g.svg

{{Tlsu|User:Example}}

{{subst:User:Example}} like {{tlr}}, but also adds "subst:" Lock-g.svg
Alternative forms 0 These ignore empty parameters.

{{Tlp|example|1|2|3|4|5||7|8|9}}

{{example|1|2|3|4|5|7|8}} up to 8 parameters; ignores empty parms Lock-r.svg

{{Tl2|example|p1|p2}}

{{example|p1|p2}} up to 2 parameters, <code> style; see docu Lock-g.svg

{{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:"; see doc Lock-g.svg

{{Tlsx|example|1|2|3|4|5|6|7|8|9}}

{{subst:example|1|2|3|4|5|...}} up to 5 parameters, adds linked "subst:", <code> style Lock-g.svg

General-purpose formatting[edit]

Comparison of template-linking templates according to the styles of generated text and link produced
Text style ↓ {{tlg}} options[note 1]
to achieve text style
Link style
Linked Unlinked Linked with subst Linked including braces
{{tlg}} options[note 1]
to achieve link style
N/A DEFAULT nolink=yes subst=yes braceinside=yes
normal DEFAULT {{tlg}}[note 1]
{{T2}}
{{tlx}}
{{tlp|1|2|...}}[note 2]
{{Template:tlr}}[note 3]
{{Template:tlu}}[note 3]
{{tlf}}[note 2]
<template link>
{{subst:tls}}
{{subst:tlsp}}
{{subst:Template:tlsu}}[note 3]
{{T}}
code code=yes {{tl2}}[note 2] {{tlc}}[note 2]
<template link>
{{subst:tlsx}} N/A
monospace plaincode=yes[note 4] {{tld}}[note 5] N/A {{subst:tltts}}[note 5] {{Tl}}[note 5]
kbd kbd=yes[note 5]
  1. a b c {{tlg}} is the most general template, allowing any combination of text style and/or link style options.
  2. a b c d Prevents wrapping of text by placing it inside <span class="nowrap">...</span> tags.
  3. a b c Allows links to templates in any namespace.
  4. {{tlg|plaincode=yes}} uses <code style="border: none; background-color: transparent;">...</code>.
  5. a b c d Displays monospaced font using <span style="font-family: monospace;">...</span>.