Template:Tlc/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>Davidgothberg
Wikilinked {{tld}} and {{tlf}}, and some other fixes.
meta>Davidgothberg
Trying even more newbie friendly documentation. But really, this is a template that should be used by template programmers...
Line 4: Line 4:
This is the {{tlc|tlc}} template.
This is the {{tlc|tlc}} template.


First a short example:
This page is also the documentation for {{tl|tld}} and {{tl|tlf}} that work almost exactly the same.


<pre>
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 <code>&lt;nowiki>&lt;/nowiki></code> tags you can write it simpler and shorter by using these templates.
{{tlc|template name|parameters}}
</pre>


Renders like this:
:{{tlc|tlc|name|parameters}} renders {{tlc|name|parameters}}
:{{tlc|template name|parameters}}
:{{tlc|tld|name|parameters}} renders {{tld|name|parameters}}
:{{tlc|tlf|name|parameters}} renders {{tlf|name|parameters}}


This page is also the documentation for some other templates that work almost exactly the same:
These templates work similarly to {{tl|tl}} and {{tlx|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|tl}} or {{tlx|tlx}}, and then use {{tlc|tlc}}, {{tld|tld}} or {{tlf|tlf}}.
* {{tl|tld}} – Looks like this: {{tld|name|parameters}}
* {{tl|tlf}} – Looks like this: {{tlf|name|parameters}}
 
These templates help writing documentation which mentions {{tlc|templates}}, or even {{tlc|templates|that|has|parameters}}. They work similarly to {{tl|tl}} and {{tlx|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|tl}} or {{tlx|tlx}}, and then use {{tlc|tlc}}, {{tld|tld}} or {{tlf|tlf}}.


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

Revision as of 20:57, 27 March 2008

This is the {{tlc}} template.

This page is also the documentation for {{tld}} and {{tlf}} 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.

{{tlc|name|parameters}} renders {{name|parameters}}
{{tld|name|parameters}} renders {{name|parameters}}
{{tlf|name|parameters}} renders {{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}} 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

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

CodeResultComment
{{tlc}} Lua error in Module:Template_link_general at line 136: attempt to concatenate local 'titlePart' (a nil value). 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|i}} 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|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.

See also