GeezerVison

Substitution bubbles. The prefix safesubst: can behave both as transclusion and substitution, depending on which kind of template usage is applied to the template with wikitext safesubst:. For example, if Template X1 contains wikitext {{safesubst:X2}}, then the following will happen:

• If a page transcludes Template X1, then {{safesubst:X2}} will behave like {{X2}} (transclusion). subst: would not evaluate.
• If a page substitutes Template X1, then {{safesubst:X2}} will behave like {{subst:X2}} (substitution). subst: would also substitute, i.e. "bubble up" to the page using Template X1.

Substitution bubbling continues through a chain of substitutions until a transclusion is reached, at which point only transclusions are used.

Templates meant exclusively for substitution should have {{subst only}} at the top of their documentation pages.

So that other users can learn to use substituted templates, top-level metatemplates that will appear in normal templates (rather than in other metatemplates) should mark their presence with a comment. This comment usually goes at the end of the template, and simply contains a link to the substituted template:

...<!--
--
-- Substituted from [[Template:Example]].
--
--></includeonly><noinclude>...

(X)HTML entities such as | (|) will not be translated during substitution, so they will never evaluate. They are only useful for preventing text from being evaluated at all.

Parameters can have default values for when they are undefined: {{{parameter-name|default-value}}}

Undefined parameter defaults are useful for escaping text that would otherwise be evaluated. For example, to break up a tag that should print as text:

{{{|<}}}example/{{{|>}}}

After the first substitution:

<example/>

Further includes would evaluate the tag.

Parameters are processed prior to substitution, so they can also be used for conditional substitution. For example, to only substitute when the nosubst parameter is undefined:

{{{{{nosubst|subst:}}}example}}

Curly braces delimit angled brackets to prevent the formation of a tag, so the easiest way to escape tags is with undefined parameter defaults. This does not have the overhead of a template call. Example:

{{{|<}}}example/{{{|>}}}

After the first substitution:

<example/>

Tags can be escaped much like braces. Alternatively, the {{lessthan}} template can be used, though it is less efficient. Producing the same result as the previous example:

<includeonly><</includeonly>example/<includeonly>></includeonly>
{{lessthan}}example/>

This is usually only necessary for includeonly, noinclude, and nowiki tags. In such a case, it is preferable to use the {{includeonly}}, {{noinclude}}, and {{nowiki}} templates, respectively:

{{includeonly|{{example}}}}

After the first substitution:

<includeonly>{{example}}</includeonly>

Further transclusions and substitutions:

This is an example of a template. For help with templates, see Help:Template.

Curly braces, if separated by <includeonly>...</includeonly> tags, will print as-is. Note that these three tags <includeonly>...</includeonly>, <noinclude>...</noinclude>, and <nowiki>...</nowiki> cannot be nested within themselves, so this trick can only be used in top-level code. <nowiki>...</nowiki> tags won't work, as they won't be removed by the substitution process. There are several possible combinations:

<includeonly>{{</includeonly>example<includeonly>}}</includeonly>
{{<includeonly>example</includeonly>}}
{{<includeonly/>example<includeonly/>}}

After the first substitution, each produces:

{{example}}

Further transclusions and substitutions:

This is an example of a template. For help with templates, see Help:Template.

A less efficient method is to use metatemplates that print braces. Unlike <includeonly>...</includeonly> tag separation, metatemplates will work when inside another wiki markup block, such as within an argument to another template. There are general-purpose metatemplates using parentheses in place of braces. This will produce a result identical to that of the previous example:

{{((}}example{{))}}

Other metatemplates for producing similar combinations:

• {{(}} produces {
• {{)}} produces }
• {{((}} produces {{
• {{))}} produces }}
• {{(((}} produces {{{
• {{)))}} produces }}}

See also Category:Template namespace templates.

The template {{braces}} can produce, for example, the following:

{{braces|Templatename|item1|item2|...|item8}}  →  {{Templatename | item1 | item2 | ... | item8}}

{{braces|code=on|Templatename|item1|item2|...|item8}}  →  {{Templatename | item1 | item2 | ... | item8}}

For more details, see Template:Braces.

These characters and sequences often need to be escaped when writing a template, but should be evaluated by future templates. Also see § Braces above. Line breaks are shown by \n.

• {{!}} produces |
• {{!!}} produces ||
• {{!(}} produces [
• {{!)}} produces ]
• {{!((}} produces [[
• {{))!}} produces ]]
• {{=}} produces =
• {{!-}} produces |-
• {{-!-}} produces  \n\n|-
• {{s-start}} produces the start of a centered table; see the s-start source code for details.
• either {{!)}} or {{s-end}} produces |}
• {{end}} also produces |}, and specifically as the terminating delimiters of a table that begins with {|
• {{lessthan}} produces <