Template:Tlc/doc: Difference between revisions
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. | ||
This page is also the documentation for {{tl|tld}} and {{tl|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 <code><nowiki></nowiki></code> tags you can write it simpler and shorter by using these templates. | ||
</ | |||
:{{tlc|tlc|name|parameters}} renders {{tlc|name|parameters}} | |||
:{{tlc| | :{{tlc|tld|name|parameters}} renders {{tld|name|parameters}} | ||
:{{tlc|tlf|name|parameters}} renders {{tlf|name|parameters}} | |||
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}}. | |||
These templates | |||
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 a documentation subpage for Template:Tlc. It may contain usage information, categories and other content that is not part of the original template page. |
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.
| Code | Result | Comment |
|---|---|---|
{{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