Template:Tlp/doc

From Crews Genealogy Wiki: focusing on the Wiregrass south, and related families
< Template:Tlp
Revision as of 08:06, 15 April 2013 by Wikiadmin (talk | contribs) (1 revision)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This is the {{Tlp}} or template link with parameters template.

It can be used in documentation and talk page discussions to show how a template name would be used in code.

Here is how this template looks. Code to the left and actual rendering to the right:

{{Tlp|name|parameters}} = {{name|parameters}}

Features of {{Tlp}}:

  • It shows a template name with a link to that template.
  • It shows up to eight parameters.
  • It also shows empty parameters. (See examples below.)
  • It prevents line wraps in its output.
  • It uses normal text style. (While for instance {{Tlx}} uses teletype text style.)

This template belongs to a whole family of similar templates. See the see also section below for some of them. For instance, when writing documentation you might want to avoid a lot of unnecessary links, since it decreases readability. Then on the first occurrence of a template name use {{Tl}}, {{Tlp}} or {{Tlx}}, and then use {{Tlf}}, {{Tld}} or {{Tlc}}.

Examples

CodeResultComment
{{tlp}} {{tlp|...}} Shows its own syntax.
{{tlp|name}} {{name}}
{{tlp|name|one}} {{name|one}}
{{tlp|name|one|two}} {{name|one|two}}
{{tlp|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.
{{tlp|name|||three|four}} {{name|||three|four}} Also shows empty parameters.
{{tlp|name|||three||}} {{name|||three||}} Even shows empty parameters that come in the end.
{{tlp|name|one=a|two=b}} {{name}} Equal signs is a problem, but there is a fix.
{{tlp|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 then some find it simpler to code it using <nowiki> tags, or the &#61; or &#x3D; character references. Here's how to do that. Code to the left and actual rendering to the right:

{{tlp|name|<nowiki>one=a|two=b</nowiki>}} = {{name|one=a|two=b}}
{{tlp|name|one&#61;a|two&#61;b}} = {{name|one=a|two=b}}

See also

Template linking templates<span style="" title="<translate nowrap> View this template</translate>"><translate> view</translate> · <span style="" title="<translate nowrap> Discuss this template</translate>"><translate> talk</translate> · <span style="" title="<translate nowrap> Edit this template</translate>"><translate> edit</translate>
Link style → Linked Unlinked Linked with subst Linked including braces Linked with alternative text
Text style ↓ {{tlg}} option1 <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>
Normal {{tl}} · {{tlp}}2 · {{tlg}}1, 2 {{tlf}}2 {{tls}} · {{tlsp}} {{tn}} {{tla}}
Code <syntaxhighlight lang="text" class="" id="" style="" inline="1">code=yes</syntaxhighlight> or
<syntaxhighlight lang="text" class="" id="" style="" inline="1">tt=yes</syntaxhighlight>
{{tlx}} {{tlc}}2 · {{tld}} · {{tnull}} {{tlxs}}  
Bold <syntaxhighlight lang="text" class="" id="" style="" inline="1">bold=yes</syntaxhighlight> {{tlb}}  
Bold code <syntaxhighlight lang="text" class="" id="" style="" inline="1">bold=yes|code=yes</syntaxhighlight> {{tlxb}}
Italic code <syntaxhighlight lang="text" class="" id="" style="" inline="1">italic=yes|code=yes</syntaxhighlight> {{tlxi}}
NOTES:  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 of ‎<span class="nowrap">...‎</span> tags.


Style comparison
  • {{tlf|Milford Haven Line|弘安源氏論議}} …renders… {{Milford Haven Line|弘安源氏論議}}
  • {{tld|Milford Haven Line|弘安源氏論議}} …renders… {{Milford Haven Line|弘安源氏論議}}
  • {{tlc|Milford Haven Line|弘安源氏論議}} …renders… {{Milford Haven Line|弘安源氏論議}}


For parameter description
  • {{para|name|{{var|value}}}} …renders… |name=value
  • {{para|name|{{varserif|value}}}} …renders… |name=value
  • {{tlx|Milford Haven Line|first parameter{{=}}first value}} …renders… {{Milford Haven Line|first parameter=first value}}

See also

Template:Tl templates