Editing Template:Nowiki template demo/doc

{{Documentation subpage}}
{{lua|Module:Template test case}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

This template shows a template invocation together with a demonstration of that template's output. The template arguments are passed in once, inside {{tag|nowiki}} tags, and are used to generate both the template invocation and the template output. The demonstration can be displayed in various different formats.

This template is identical to {{tl|test case nowiki}} with the {{para|showtemplate2}} and {{para|showheader}} parameters both set to "no". To see the full range of options available, please see the [[Template:Test case nowiki/doc|test case nowiki documentation]].

== Usage ==
===Basic syntax===
<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{nowiki template demo|<nowiki>{{[template name]
| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}</nowiki>}}

<!-- Or -->

{{nowiki template demo|<nowiki>{{<!-- template name with parameters -->}}</nowiki>}}

</syntaxhighlight>

===Common syntax===
The following options will work with all different test case formats.

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{nowiki template demo
| format      = 
| collapsible = 
| resetRefs   = 
| showcode    = 
| showheader  = 
| code        = <nowiki>{{[template name]
| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}</nowiki>
}}
</syntaxhighlight>

Some test case formats accept additional parameters as well. See their sections for documentation.

== Parameters ==

{| class="wikitable"
|+ Common parameters
|-
! Parameter !! Description
|-
| <code>code</code> or <code>1</code> || The template code, inside {{tag|nowiki}} tags. You must use the magic word "__TEMPLATENAME__" instead of the template name. For example: <code><nowiki>| code = &lt;nowiki&gt;{{__TEMPLATENAME__|first|second|foo=bar}}&lt;/nowiki&gt;</nowiki></code>. <p>Note: due to the way nowiki tags work, the template treats the [[HTML entities]] &amp;lt;, &amp;gt; and &amp;quot; as if they were the literal characters &lt;, &gt; and &quot; when used with this parameter.</p>
|-
| <code>format</code> || The format to display the test cases in. This can be "default", "inline", "columns" or "rows". The inline format is for templates that can be displayed entirely on one line. If used with templates that display on multiple lines it may produce unexpected results. The "columns" and "rows" formats are intended for displaying multiple templates in a table, so they are not of much use here. See the [[Template:Test case nowiki/doc|test case nowiki documentation]] for more information about them.
|-
| <code>heading1</code> || A custom heading for the template.
|-
| <code>showheader</code> || If this is set to "no", then no headers are shown.
|-
| <code>collapsible</code> || If set to "yes", the demonstration is made collapsible. It is collapsed by default.
|-
| <code>resetRefs</code> || If set to "yes", any references generated by the templates tested are reset after each template is expanded.
|-
| <code>showcode</code> || Set this to "no" to disable display of the template invocation.
|}

You can use {{para|collapsible|yes}} with any format to collapse it. You can set a custom title for collapsible test cases with the {{para|title}} parameter.

== Examples ==

=== Default ===
====Usage====
<pre style="white-space:pre-wrap; overflow:auto; background-color:#eee;">
{{nowiki template demo|code=&lt;nowiki>{{ombox|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}&lt;/nowiki>}}
</pre>
====Output====
{{nowiki template demo|code=<nowiki>{{ombox|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}</nowiki>}}

=== Default, collapsible ===
====Usage====
<pre style="white-space:pre-wrap; overflow:auto; background-color:#eee;">
{{nowiki template demo|collapsible=yes|&lt;nowiki>{{ombox|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}&lt;/nowiki>}}
</pre>
====Output====
{{nowiki template demo|collapsible=yes|<nowiki>{{ombox|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}</nowiki>}}

=== Inline ===
using [[Template:3x]]
====Usage====
<pre style="white-space:pre-wrap; overflow:auto; background-color:#eee;">
{{nowiki template demo|format=inline|code=&lt;nowiki>{{3x|Lorem ipsum}}&lt;/nowiki>}}
</pre>
====Output====
{{nowiki template demo|format=inline|code=<nowiki>{{3x|Lorem ipsum}}</nowiki>}}

Note: As this format starts with a bullet, a newline will always be inserted at the start of the template output due to [[phab:T14974|bug 14974]].

=== Inline with nowiki output ===
using [[Template:URL]]
====Usage====
<pre style="white-space:pre-wrap; overflow:auto; background-color:#eee;">
{{nowiki template demo|format=inline|output=nowiki+|code=&lt;nowiki>{{URL | 1= http://www.example.com/path?section=17 }}&lt;/nowiki>}}
</pre>
====Output====
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{URL | 1= http://www.example.com/path?section=17 }}</nowiki>}}

== Technical limitations ==

The template has the following known technical limitations:
* An error will be generated if processing the entire page takes more than 10 seconds. This is an intentional limit in the [[mw:Extension:Scribunto|Scribunto]] extension that runs [[Module:Template test case]], on which this template is based. If a test cases page takes more than 10 seconds to load, you may need to split it up into different pages.
* The template converts the [[HTML entities]] &amp;lt;, &amp;gt; and &amp;quot; inside template invocations to the literal characters &lt;, &gt; and &quot;. This is due to the way nowiki tags work.

== See also ==
Similar templates:
* [[Template:Demo]] and [[Template:Demo-inline]] which use [[Module:Demo]]
* [[Template:Automarkup]] which uses [[Module:Automarkup]]

Templates invoking [[Module:Template test case]]:
* [[Template:Test case]] – a generalised test case template
* [[Template:Testcase rows]] – for a table of test cases arranged in rows
* [[Template:Testcase table]] – for a table of test cases arranged in columns
* [[Template:Inline test case]] – for test cases with small invocations and small output
* [[Template:Collapsible test case]] – for test cases collapsed by default if the results are the same

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Documentation assistance templates]]
[[Category:Programming typing-aid templates]]
[[Category:Template test cases| ]]
[[Category:Nowiki templates]]
[[Category:Wikitext processing templates]]
}}</includeonly>