قالب:Nowiki template demo/شرح
هذه صفحة توثيق قالب:Nowiki template demo الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه. |
هذا القالب يستعمل لوا: |
This template shows a template invocation together with a demonstration of that template's output. The template arguments are passed in once, inside <nowiki></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 {{test case nowiki}} with the |showtemplate2=
and |showheader=
parameters both set to "no". To see the full range of options available, please see the test case nowiki documentation [الإنجليزية].
Usage
[عدل]Basic syntax
[عدل]{{nowiki template demo|<nowiki>{{[template name]
| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}</nowiki>}}
<!-- Or -->
{{nowiki template demo|<nowiki>{{<!-- template name with parameters -->}}</nowiki>}}
Common syntax
[عدل]The following options will work with all different test case formats.
{{nowiki template demo | format = | collapsible = | resetRefs = | showcode = | showheader = | code = <nowiki>{{[template name] | [param1] = [value1] | [param2] = [value2] | [param3] = [value3] ... }}</nowiki> }}
Some test case formats accept additional parameters as well. See their sections for documentation.
المعلمات
[عدل]Parameter | Description |
---|---|
code or 1 |
The template code, inside <nowiki></nowiki> tags. You must use the magic word "__TEMPLATENAME__" instead of the template name. For example: | code = <nowiki>{{__TEMPLATENAME__|first|second|foo=bar}}</nowiki> . Note: due to the way nowiki tags work, the template treats the HTML entities <, > and " as if they were the literal characters <, > and " when used with this parameter. |
format |
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 test case nowiki documentation [الإنجليزية] for more information about them. |
heading1 |
A custom heading for the template. |
showheader |
If this is set to "no", then no headers are shown. |
collapsible |
If set to "yes", the demonstration is made collapsible. It is collapsed by default. |
resetRefs |
If set to "yes", any references generated by the templates tested are reset after each template is expanded. |
showcode |
Set this to "no" to disable display of the template invocation. |
You can use |collapsible=yes
with any format to collapse it. You can set a custom title for collapsible test cases with the |title=
parameter.
أمثلة
[عدل]Default
[عدل]Usage
[عدل]{{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>}}
Output
[عدل]{{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.}}
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. |
Default, collapsible
[عدل]Usage
[عدل]{{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>}}
Output
[عدل]{{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.}}
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. |
Inline
[عدل]using قالب:3x
Usage
[عدل]{{nowiki template demo|format=inline|code=<nowiki>{{3x|Lorem ipsum}}</nowiki>}}
Output
[عدل]{{3x|Lorem ipsum}}
← قالب:3x
Note: As this format starts with a bullet, a newline will always be inserted at the start of the template output due to bug 14974.
Inline with nowiki output
[عدل]using قالب:مسار
Usage
[عدل]{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{URL | 1= http://www.example.com/path?section=17 }}</nowiki>}}
Output
[عدل]{{URL | 1= http://www.example.com/path?section=17 }}
← www.example .com /path?section=17 <span class="url">[http://www.example.com/path?section=17 www<wbr/>.example<wbr/>.com<wbr/>/path?section=17]</span>
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 Scribunto extension that runs وحدة: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 <, > and " inside template invocations to the literal characters <, > and ". This is due to the way nowiki tags work.
طالع أيضاً
[عدل]Similar templates:
- قالب:Demo and قالب:Demo-inline which use وحدة:Demo
- قالب:Automarkup which uses وحدة:Automarkup
Templates invoking وحدة:Template test case:
- قالب:Test case – a generalised test case template
- قالب:Testcase rows – for a table of test cases arranged in rows
- قالب:Testcase table – for a table of test cases arranged in columns
- قالب:Inline test case – for test cases with small invocations and small output
- قالب:Collapsible test case – for test cases collapsed by default if the results are the same