hiwiki:Template sandbox and test cases का स्रोत देखें

{{Wikipedia how to|WP:TEMPTEST|WP:TESTCASE|WP:TESTCASES}}

[[Help:Template|Templates]] are a very powerful feature of [[MediaWiki]], but mistakes can be easily made, even by experienced users. Complex templates should therefore be accompanied by '''[[Sandbox (software development)|sandboxes]]''' and '''[[test case]]s''' to prevent bugs.

== For what kind of templates ==

It is recommended to apply the test case pattern to templates using [[mw:Help:Extension:ParserFunctions|ParserFunctions]] that can generate very different looking output, such as the ones that take many parameters, or the ones that have many branches of the <tt>#switch</tt> operator.

For navigational boxes, of which the outputs are almost identical on each transcluding page, the benefit may not outweight the time and effort.

Any template that is transcluded in thousands of pages should of course be tested before an edit is made.

== Prerequisite ==

The template must be properly documented following [[Wikipedia:Template documentation]].

Furthermore, the template should not have too many interleaving <tt><nowiki><includeonly></nowiki></tt> and <tt><nowiki><noinclude></nowiki></tt> blocks. Ideally there is only one <tt><nowiki><noinclude></nowiki></tt> block, placed at the bottom of the template, and containing the {{tl|documentation}} template.

== How to create /sandbox and /testcases subpages ==

1: Suppose your template is named <tt>Template:X</tt>. Create a subpage with the name <tt>Template:X/sandbox</tt> and another with <tt>Template:X/testcases</tt>. When these subpages are present, the green /doc box produced by {{tl|documentation}} automatically provide links to them. Note that "/sandbox" and "/testcases" are spelled in all lower-case.

2: Copy only the code (everything that is not surrounded by <tt><nowiki><noinclude></nowiki></tt>) from your <tt>Template:X</tt> to <tt>Template:X/sandbox</tt>. And add the following at the end of the last line, in the same line:

:<code style="display:table; line-height:1.2em;">&lt;noinclude><br><br><nowiki>{{template sandbox notice}}</nowiki><br>&lt;/noinclude></code>

In other words, the result should be:

:<code style="display:table; line-height:1.2em;"><span style="background-color: #FFFF66">[-- Template code --]</span>&lt;noinclude><br><br><nowiki>{{template sandbox notice}}</nowiki><br>&lt;/noinclude></code>

'''Note!''' The template code must start directly before and touch the <code>&lt;noinclude></code> tag. Any blank space or newlines between the template code and the <code>&lt;noinclude></code> tag can cause the template to render unwanted spaces or newlines when used.

3: Copy a few transcluding examples from articles (<tt><nowiki>{{X | .... }}</nowiki></tt>) to your <tt>Template:X/testcases</tt>. In the test case subpage, duplicate each example, and for '''one copy''' of each example, replace <tt>X</tt> with <tt>X/sandbox</tt>. This is done so that you may compare the old and new outputs side by side in the future. Lastly, add the following line at the beginning of the test case page. It does not matter how many blank lines you put around it:

:<code style="display:table; line-height:1.2em;"><nowiki>{{template test cases notice}}</nowiki></code>

4: Thus <tt>Template:X/testcases</tt> will look like this:
<pre>
 {{template test cases notice}}

 {{X | foo}}
 {{X/sandbox | foo}}

 {{X | bar}}
 {{X/sandbox | bar}}
</pre>

4b: To make differences easier to identify, you can use [[Template:Testcase]] to lay out your test cases.  Then, test cases which are changed in the sandbox are highlighted so you can double check that the change was intentional.

== How to use them subsequently ==

* Sync sandbox from the real template (i.e. step 2 above)
* Have fun editing the sandbox
* Verify the test cases
* If everything looks good, copy the code from the sandbox to the real template

If you chose not to compare the new and old outputs side by side described at the last bullet point of the previous section, it is recommended to use a [[Tab (GUI)|tabbed]] [[Web browser|browser]] and open the test case subpage before changing the sandbox, and another after changing the sandbox. This can ensure that the differences are compared accurately.

== Example ==
* {{tl|Infobox Country}}
* {{tl|Infobox Settlement}}

== Test with other users - {{tl|test-mode}} ==

If you are satisfied with the changes that you made in the sandbox version, and with what the test cases show - you might consider trying {{tl|test-mode}}.  This will enable several users to browse pages on Wikipedia with the test version of your template, and yet not affect anyone else displaying those pages.

== See also ==

* [[Wikipedia:High-risk templates]]
* {{tl|template sandbox notice}} – To put at the bottom of /sandbox pages.
* {{tl|template test cases notice}} – To put on top of /testcases pages.
* {{tl|test-mode}} - allow editors with "test-mode" on to display wikipedia pages with test template instead of public template.

[[Category:साँचे|{{PAGENAME}}]]