Tynian: 1 revision: Import helps

2011-01-10T23:24:21Z

1 revision: Import helps

New page

{{H:h}}[[Category:Editor handbook]]

This page covers '''advanced template techniques''', in particular the use of variable template names and parameter names in templates. Readers should be thoroughly familiar with the standard template techniques found in [[Help:Template]]. Some techniques described below may be outdated or of limited use; for example, [[mw:Help:Extension:ParserFunctions|ParserFunctions]] may be more convenient than some of the branching techniques discussed.

In general, these techniques rely on the recursive (inside-out) processing of templates. When a template is [[Help:Expansion|expanded]] (processed), it translates template code into string values. These are often sent directly to the web browser for display, but they can be treated as code themselves. By enclosing the text strings in double-curly-brackets ( {{}} ), for instance, they can be reprocessed as template names or variable names, producing different results as the string values are changed.

'''Notes:'''
*This document refers to features currently only available in the Mediawiki software starting with version 1.6 and later.
*The term "variable" has two uses in this document:
**As noun it means [[mw:Help:Magic_words#Variables|a type of magic word]], which is a system-based variable that can be accessed in the same manner as templates (thus <nowiki>{{NAMESPACE}}</nowiki> will return the name of the current namespace, depending on the page).
**As adjective or adverb, it is used in the general sense, to indicate that something may vary with context (thus a "variable template name" means that the name of the template being called can change according to parameters or variables).
*Using "subst:" with manual recursion gives a stepwise replacement, useful for analyzing and explaining the working of templates calling other templates. For instance, compare <code><nowiki>{{{{tctc}} }}</nowiki></code> (discussed below) with <code><nowiki>{{{{subst:tctc}} }}</nowiki></code> on a sandbox page. Though both produce the same ''visible'' result, the first will remain as the full code <code><nowiki>{{{{tctc}} }}</nowiki></code>, while the second will replace the inner template <code><nowiki>{{tctc}}</nowiki></code> with its value, leaving the code <code><nowiki>{{tc }}</nowiki></code>. See, e.g., [[Template talk:Lop]].

== Variable templates ==

<section begin=vartemp />In some cases, it may be useful for a template to call different templates depending on a variable or a passed parameter. This allows a type of [[w:en:Conditional_branching#Choice|branching]] that can be simpler than with [[mw:Help:Extension:ParserFunctions|ParserFunctions]], though they are generally less versatile.<section end=vartemp />

'''Examples:'''

;''Using a variable to choose a template'' - <code><nowiki>{{ {{NAMESPACE}} }}</nowiki></code>:The [[Help:Magic_word|magic word]] <nowiki>{{NAMESPACE}}</nowiki> returns the current namespace, like so: <nowiki>{{NAMESPACE}}</nowiki> = ''{{NAMESPACE}}''. The outer brackets then process this result as a template in its own right - in this case [[Template:Help]] - which produces ''{{ {{NAMESPACE}} }}''.
;''Using a template to choose a template'' - <code><nowiki>{{{{tctc}} }}</nowiki></code>:the template {{tl|Tctc}} contains the text "tc". This text is processed by the outer brackets as [[Template:tc]] which contains the word "{{{{tctc}} }}".

The extra spaces in the above examples are needed: without them, the pair of inner three braces is taken as those for a parameter. On the page itself it just shows as plain text: {{{{NAMESPACE}}}}.

;''Using a parameter to choose a template'' - <code><nowiki>{{{{{2}}}x|{{{1}}}}}</nowiki></code>:The second parameter passed becomes part of the template name to which the first parameter is passed. In this case <code>{{tlx|2x|{{{1}}}}}</code> would produce <code><nowiki>{{{1}}}{{{1}}}</nowiki></code>, <code>{{tlx|3x|{{{1}}}}}</code> would produce <code><nowiki>{{{1}}}{{{1}}}{{{1}}}</nowiki></code>, and etc. [[Template:Histogram]] uses this technique repeatedly in {{tlx|histogram|X|4|7|3|2|9}} to produce the following 5 line histogram:

<blockquote>{{hist5|X|4|7|3|2|9}}</blockquote>

Using [[parser functions]] and templates, including those which process strings (see [[Help:String functions]] and [[:Category:String templates]]), a template name can also depend in a more complicated way on parameters and/or variables.

== Templates passed as parameters ==

Templates can be passed as parameters to other templates. This can mean either that the template is evaluated and the result is passed as a parameter or that the template name is passed and evaluated as part of the other template.

;''Passing a template result'' - <nowiki>{{3x|{{tc}}}}</nowiki>:[[Template:3x]] contains <nowiki>{{{1}}}{{{1}}}{{{1}}}</nowiki>. <nowiki>{{3x|{{tc}}}}</nowiki> first evaluates {{tl|tc}} (which yields the word ''in''), and passes that to template {{tl|3x}}, to give {{3x|{{tc}}}}
;''Passing a template result recursively'' - <nowiki>{{3x|{{5x|{{tc}}}}}}</nowiki>:Just as above except {{tl|tc}} (''in'') is first passed to {{tl|5x}} and the result of that is passed to {{tl|3x}}, to give {{3x|{{5x|{{tc}}}}}}.


;''Passing a template name'' - <code><nowiki>{{tt|t|V}}</nowiki></code>:'''[[Template:tt]]''' - <code><nowiki>{{{{{1}}}|a{{{2}}}b{{{2}}}c{{{2}}}d}}</nowiki></code> - takes the value '''V''' (passed as the second parameter) and produces ''aVbVcVd''. This value is then passed to '''[[template:t]]''' (which was passed by name as the first parameter), producing "{{tt|t|V}}"

== Variable parameter name ==

A parameter name in a template can be the value of another parameter. This is useful if you want the behavior of a template to change based on the information that is provided to it.

'''''Choosing parameters contextually -''''' <code><nowiki>{{t pnd|parameter name}}</nowiki></code>
<blockquote>
[[Template:t p]] contains <code><nowiki>{{{capital}}} is the capital of {{{country}}}</nowiki></code>, with two parameters - "capital" and "country". {{timc|t pnd}} can be used to select ''which'' parameter is used in a particular case. Thus:

{| class="wikitable"
|-
!This...
!Produces this
|-
|{{tlx|t pnd|capital}}
|{{t pnd|capital}}
|-
|{{tlx|t pnd|country}}
|{{t pnd|country}}
|-
|{{tlx|t pnd|something else}}
|{{t pnd|something else}}
|}

This applies to integer parameters as well, since integer parameters can be specified using the "#=" notation. Passing the integer value N to {{tl|t pnd}} as its parameter will make it look for the Nth unnamed parameter.
</blockquote>
;''Parameter name from another parameter in the same template'' - <code><nowiki>{{ppp|p=foo|foo=bar}}</nowiki></code>: using [[Template:ppp]], which contains <code><nowiki>{{{{{{p}}}}}}</nowiki></code>, the code <code>{{ppp|p=foo|foo=bar}}</code> will first set the parameter named "foo" to the value "bar", and then set the parameter named "p" to the value of foo, yielding {{ppp|p=foo|foo=bar}}. The order in which the parameters appear in the code does not matter, but the technique cannot be applied multiple times—e.g., using [[Template:tvvv]], which contains <code><nowiki>{{{{{{{{{p}}}}}}}}}</nowiki></code>, <code><nowiki>{{tvvv|p=foo|foo=bar|bar=biz}}</nowiki></code> gives {{tvvv|p=foo|foo=bar|bar=biz}}.

This is e.g. applied in [[w:Template:Reg polyhedra db]], which contains a 2D array in the form {{{{{1}}}|{{{2}}}|1-1=a11|..|m-n=amn}}. The first parameter is the name of a template that provides a particular selection and presentation of a selected row of the array, e.g. [[w:Template:Reg polyhedron stat table]], the second parameter (which is the first parameter of the latter template) specifies the row. The latter templates references element j of the row concerned by a tag of the form {{{{{{1}}}-j}}}

Whilst the same output could also be produced using {#switch:}, this method is less intensive on the server and may help to stay under page limits; see [[Help:Array]].

==Branching techniques without ParserFunctions==
The parameter default feature was introduced before [[mw:Help:Extension:ParserFunctions|Extension:ParserFunctions]]. This led to the development of branching methods through the parameter default mechanism.

;''If-defined branches'' - <code><nowiki>{{{test{{{test|}}}|{{{then}}}}}}</nowiki></code>:If no value is passed for the parameter test, then <nowiki>{{{test{{{test|}}}|{{{then}}}}}}</nowiki> resolves to <nowiki>{{{test|{{{then}}}}}}</nowiki> and returns a blank entry (since test is defined as blank). If the parameter "test" is assigned the value "boo", however, <nowiki>{{{test{{{test|}}}|{{{then}}}}}}</nowiki> resolves to <nowiki>{{{testboo|{{{then}}}}}}</nowiki>, and so long as no parameter "testboo" exists, then this will return the value of the parameter "then".

See [[Template:Ifwpc]] for comparisons.

There was also an [[Help:Array#Array technique using parameter defaults|array technique using parameter defaults]], with the disadvantage that a template using this technique had to be called with, in addition to the normal parameters, a standard parameter definition not reflecting a choice, but necessary to make the template work.

An even older branching technique dates from before the introduction of the parameter default mechanism. It is based on the fact that if in a template call a parameter is assigned a value more than once, the last one counts. This is used in combination with specifying the value of a parameter in a template call, where the name of that parameter depends on a parameter of an outer template. In a call <code><nowiki>{{a|b=c|{{{d}}}=e}}</nowiki></code>, template:a uses b=c if b≠{{{d}}} and b=e if b={{{d}}}. See [[Template:T pdc]].

Another old "branching technique" is using a template name depending on the value of a parameter (see above).

== Variable variable names ==

;''Magic word depending on a template'' - <code><nowiki>{{t curr}}</nowiki></code>: {{timc|t curr}} gives the text ''{{CURRENT{{t day}}}}'' without parameters, since it defaults to <nowiki>{{CURRENTDAY}}</nowiki>, but {{tlx|t curr|DAYNAME}} gives ''{{t curr|DAYNAME}}'' while {{tlx|t curr|MONTHNAME}} gives ''{{t curr|MONTHNAME}}''. Any magic word that begins with "CURRENT" can be accessed this way.

;''Parser function parameter depending on a template parameter'' - <code><nowiki>{{ns:{{{1}}}}}</nowiki></code>:In [[Template:Namespace]], which contains "<code>{{msgnw:namespace}}</code>", <code><nowiki>{{namespace|4}}</nowiki></code> gives "{{namespace|4}}", because ''Meta'' is the name of namespace 4.

== External examples ==
*VARIABLE MAGIC WORDS
**[[Template:H:h]] and [[Template:H:f]] (see edit pages, [[Help:MediaWiki_help_policy#Keeping_project-specific_material_separate|MediaWiki help policy]], and [http://meta.wikimedia.org/w/index.php?title=Special:Allpages/h&namespace=10 list])
**[[Template:Nsn]] - namespace number (see also below)
**[[Template:Gns]] - generic namespace name, useful for linking to the corresponding page on another project
**[[:de:MediaWiki:Newarticletext]] and [[:de:MediaWiki:Noarticletext]] (see edit pages and [http://de.wikipedia.org/w/index.php?title=Spezial:Allpages/MediaWiki&namespace=10 list])
**[[w:en:Template:H:f]] - for project-specific content on all help pages of the English Wikipedia (requires a blank template on all pages that do not have this content)



==See also==
*[[mw:Help:Extension:ParserFunctions|ParserFunctions]] (Syntax for <tt><nowiki>#if:, #expr:</nowiki></tt> etc.)
*[[Meta talk:Templates for translating language names]]
*[[Help:Array]]

{{h:f|enname=Advanced templates}}

Help:Advanced templates - Revision history

Tynian: 1 revision: Import helps