Template:Tle/doc: Difference between revisions
More actions
m grammar |
m expansion |
||
| Line 14: | Line 14: | ||
|4d=parameter name | |4d=parameter name | ||
|4stat=optional- | |4stat=optional- | ||
|5=f | |||
|5d=possible value to format the display - see [[#Format example]] | |||
|5stat=optional- | |||
|name=Tle | |name=Tle | ||
| Line 29: | Line 32: | ||
Wikimedia Commons has lots of other '''template templates''', but none is really able to describe complicated parametrizing easily. | Wikimedia Commons has lots of other '''template templates''', but none is really able to describe complicated parametrizing easily. | ||
{{Tle}} describes each parameter as a meta-pair <code>|pn= |n= </code>, an ''optional'' meta-parameter p1...p25 for the name and an ''optional'' unnamed meta-parameter for the value.<br> | |||
For unnamed parameters this name can be the number; if even that is not needed, some or all meta-parameter ''names'' may dismiss. | For unnamed parameters this name can be the number; if even that is not needed, some or all meta-parameter ''names'' may dismiss. | ||
| Line 45: | Line 48: | ||
{{Tle|t=example|parm-value1|parm-value2 | ...|parm-value{{Smallsub|n}}}} | {{Tle|t=example|parm-value1|parm-value2 | ...|parm-value{{Smallsub|n}}}} | ||
Values can as well be empty - | Values can as well be empty - but it may ''not'' be a very useful template description to say nothing about a value. | ||
=== Restriction === | === Restriction === | ||
While the '''values''' can be specified without names, it makes no sense to specify a '''name''' without its value; at least an empty value is necessary.<br> | While the '''values''' can be specified without names, it makes no sense to specify a '''name''' without its value; at least an empty value is necessary.<br> | ||
Because possibly parameter ''names'' are checked only when there is a parameter ''value'', superfluous ''names without values'' will be ignored: | |||
:<tt><nowiki>{{Tle|t=m||||p3=parameter#3}}</nowiki></tt> will give {{Tle|t=m||||p3=parameter#3}} | :<tt><nowiki>{{Tle|t=m||||p3=parameter#3}}</nowiki></tt> will give {{Tle|t=m||||p3=parameter#3}} | ||
:<tt><nowiki>{{Tle|t=m||||p4=superfluous}}</nowiki></tt> will give {{Tle|t=m||||p4=superfluous}} | :<tt><nowiki>{{Tle|t=m||||p4=superfluous}}</nowiki></tt> will give {{Tle|t=m||||p4=superfluous}} | ||
== Examples == | == Examples == | ||
| Line 62: | Line 66: | ||
Without any meta-parameter, {{Tl|Tle|incl=0}} just shows the template name: {{Tle|T=clr}} or {{Tle|t=clr}}.<br> | Without any meta-parameter, {{Tl|Tle|incl=0}} just shows the template name: {{Tle|T=clr}} or {{Tle|t=clr}}.<br> | ||
With neither <code>T</code> nor <code>t</code> the default template name will be <tt>Tle</tt>. | With neither <code>T</code> nor <code>t</code> the default template name will be <tt>Tle</tt>. | ||
=== Format example === | |||
The parameter <code>f</code> allows to format the display: its value precedes each parameter. The following example shows how this can be done with <code><nowiki>f=<br>{{0}}</nowiki></code> | |||
<br>{{Color|b|bg=#DFD| | |||
{{Tle|t=Image generation | |||
|p1=SVG tool|Inkscape | |||
|p2=W3C error count|3 | |||
|p3=Text as path|yes | |||
|p4=Grapic Lab|de | |||
|p5=Topic|strukural formula | |||
|f=<br>{{0}}}}}}<br> | |||
{{Commons:Link templates/Template links}} | {{Commons:Link templates/Template links}} | ||
Revision as of 15:33, 2 July 2019
Meta template for template description. Describes template parameters
Usage
{{Tle |T= }}
Template parameters
| Parameter | Description | Default | Status | |
|---|---|---|---|---|
T | name of the template; Will be displayed as linkable item | Tle | optional | |
t | name of the template; Will be displayed as plain text When parameter "T" is specified, an additional parameter "t" is ignored | empty | optional | |
1 … 25 | parameter value; may contain wiki syntax, if necessary | empty | optional | |
p1 … p25 | parameter name | empty | optional | |
f | possible value to format the display - see #Format example | empty | optional | |
Additional information
The template is intended to be used in the following namespaces: all namespaces
The template is intended to be used by the following user groups: all users == Localization ==
The template does not generate any localizable text.
Explanation
It is necessary to distinguish between a template and its parameter names and parameter values, and this meta-template with its meta-parameter-names and meta-parameter-values.
Wikimedia Commons has lots of other template templates, but none is really able to describe complicated parametrizing easily.
{{ Tle }} describes each parameter as a meta-pair |pn= |n= , an optional meta-parameter p1...p25 for the name and an optional unnamed meta-parameter for the value.
For unnamed parameters this name can be the number; if even that is not needed, some or all meta-parameter names may dismiss.
How to use
After specifying the template name, its parameter values are specified with the unnamed meta-parameters; its parameter names can be specified with the meta-parameters p1 to pn.
To describe the parameters of template Tle, the following can be used:
{{ Tle | T = Tle | 1 = parm-value1 | 2 = parm-value2 | ... | n = parm-valuen | p1 = parm-name1 | p2 = parm-name2 | ... | pn = parm-namen }}
A template with only unnamed parameters may look like e.g.
{{ Example | 1 = parm-value1 | 2 = parm-value2 | ... | n = parm-valuen }}
or without the numbers
{{ Example | parm-value1 | parm-value2 | ... | parm-valuen }}
Values can as well be empty - but it may not be a very useful template description to say nothing about a value.
Restriction
While the values can be specified without names, it makes no sense to specify a name without its value; at least an empty value is necessary.
Because possibly parameter names are checked only when there is a parameter value, superfluous names without values will be ignored:
- {{Tle|t=m||||p3=parameter#3}} will give {{ M | parameter#3 = }}
- {{Tle|t=m||||p4=superfluous}} will give {{ M }}
Examples
The template:{{Color}} has two unnamed parameters (1=color, 2=text) and three named parameters (bg, title and css). With
{{Tle|T=color|text color|any text|p3=bg|background color|p4=title|tooltip text|p5=css|CSS attributes}}
this description is made: {{ Color | text color | any text | bg = background color | title = tooltip text | css = CSS attributes }}
{{Tle|t=C| | | | | | | | | }} will just display {{ C }}
Without any meta-parameter, {{Tle}} just shows the template name: {{ Clr }} or {{ Clr }}.
With neither T nor t the default template name will be Tle.
Format example
The parameter f allows to format the display: its value precedes each parameter. The following example shows how this can be done with f=<br>{{0}}
{{ Image generation
| SVG tool = Inkscape
| W3C error count = 3
| Text as path = yes
| Grapic Lab = de
| Topic = strukural formula }}
{{Commons:Link templates/Template links}}