View source for Template:Expand wikitext/doc

{{Distinguish|Template:Eval}}
{{Documentation subpage}}
{{High-use}}
{{lua|Module:Expand wikitext}}
Interprets the input as wikitext using the <code>[[mw:Extension:Scribunto/Lua reference manual#frame:preprocess|frame:preprocess]]</code> function. Any arguments passed to {{tl|Expand wikitext}} are available in the preprocessed code, letting this be used as a rudimentary way of using variables.  

If the entire input is in a nowiki tag, or if the optional parameter {{para|unstrip|yes}} is specified, first extracts the contents of nowiki tags before preprocessing.

== Examples ==
* {{tlx|Expand wikitext|If there is no wiki markup, the template doesn't do anything.}} → {{Expand wikitext|If there is no wiki markup, the template doesn't do anything.}}
* {{tlx|Expand wikitext|Wiki markup wrapped in nowiki is not expanded without the unstrip parameter: <nowiki><nowiki>Foo ''bar''</nowiki></nowiki>}} → {{Expand wikitext|Wiki markup wrapped in nowiki is not expanded without the unstrip parameter: <nowiki>Foo ''bar''</nowiki>}}
* {{tlx|Expand wikitext|Wiki markup wrapped in nowiki is expanded with the unstrip parameter: <nowiki><nowiki>Foo ''bar''</nowiki></nowiki>|unstrip{{=}}yes}} → {{Expand wikitext|Wiki markup wrapped in nowiki is expanded with the unstrip parameter: <nowiki>Foo ''bar''</nowiki>|unstrip=yes}}
* {{tlx|Expand wikitext|<nowiki><nowiki>If the whole text is wrapped in nowiki, it is expanded without the unstrip parameter: Foo ''bar''</nowiki></nowiki>}} → {{Expand wikitext|<nowiki>If the whole text is wrapped in nowiki, it is expanded without the unstrip parameter: Foo ''bar''</nowiki>}}
* {{tlx|Expand wikitext|<nowiki><nowiki>{{As of|2015|02}}</nowiki></nowiki>}} → {{Expand wikitext|<nowiki>{{As of|2015|02}}</nowiki>}}
* {{tlx|Expand wikitext|<nowiki>Wikitext produced by a template invocation is expanded: {{Make code|<<As of!2015!02>>}}</nowiki>}} → {{Expand wikitext|Wikitext produced by a template invocation is expanded: {{Make code|<<As of!2015!02>>}}}}
* {{tlx|Expand wikitext|<nowiki><nowiki>The value of foo is {{{foo}}}</nowiki></nowiki>|foo{{=}}123}} → {{Expand wikitext|<nowiki>The value of foo is {{{foo}}}</nowiki>|foo=123}}
* {{tlx|Expand wikitext|<nowiki><nowiki>The value of foo minus 56 is {{#expr:({{{foo}}})-56}}</nowiki></nowiki>|foo{{=}}123}} → {{Expand wikitext|<nowiki>The value of foo minus 56 is {{#expr:({{{foo}}})-56}}</nowiki>|foo=123}}

The template may produce unexpected results in case the wikitext contains a dash <code>-</code> right before or after a template invocation, i.e. <code>-{</code> or <code>}-</code>, because these are interpreted as language converter markup. See {{phab|T168759}} and [[mw:Writing systems/Syntax]] for details. As a workaround, replace <code>-</code> by <code>&amp;#45;</code>.
* {{tlx|Expand wikitext|<nowiki><nowiki>This works. - {{2x|x}} -</nowiki></nowiki>}} → {{Expand wikitext|<nowiki>This works. - {{2x|x}} -</nowiki>}}
* {{tlx|Expand wikitext|<nowiki><nowiki>This doesn't work. -{{2x|x}}</nowiki></nowiki>}} → {{Expand wikitext|<nowiki>This doesn't work. -{{2x|x}}</nowiki>}}
* {{tlx|Expand wikitext|<nowiki><nowiki>This doesn't work. {{2x|x}}-</nowiki></nowiki>}} → {{Expand wikitext|<nowiki>This doesn't work. {{2x|x}}-</nowiki>}}
* {{tlx|Expand wikitext|<nowiki><nowiki>This works. &amp;#45;{{2x|x}}&amp;#45;</nowiki></nowiki>}} → {{Expand wikitext|<nowiki>This works. &#45;{{2x|x}}&#45;</nowiki>}}

The template escapes HTML tags in input that is wrapped in <code>&lt;nowiki></code>, which may produce unexpected results:
* <syntaxhighlight lang="wikitext" inline>{{Expand wikitext|'''bold''', <b>bold</b>, ''italic'', <i>italic</i>}}</syntaxhighlight> → {{Expand wikitext|'''bold''', <b>bold</b>, ''italic'', <i>italic</i>}}
* <syntaxhighlight lang="wikitext" inline>{{Expand wikitext|'''bold''', <b>bold</b>, <nowiki>''italic'', <i>italic</i></nowiki>|unstrip=yes}}</syntaxhighlight> → {{Expand wikitext|'''bold''', <b>bold</b>, <nowiki>''italic'', <i>italic</i></nowiki>|unstrip=yes}}
* {{tlx|Expand wikitext|<nowiki><nowiki>'''bold''', <b>bold</b>, ''italic'', <i>italic</i></nowiki></nowiki>}} → {{Expand wikitext|<nowiki>'''bold''', <b>bold</b>, ''italic'', <i>italic</i></nowiki>}}

== See also ==
* {{tl|Make code}}
* {{tl|Call wikitext}} - Always unstrips nowiki tags and uses {{para|sourceCode}} to avoid parameter overlap

<includeonly>{{sandbox other||
[[Category:Documentation assistance templates]]
[[Category:Wikitext processing templates]]
}}</includeonly>