ZoeySaurusRawr: Created page with "{{((}}{{PAGENAME}}{{#if: {{{sub|}}}|/{{{sub}}}|}}{{#if: {{{1|}}} | {{!}} {{{1}}} |}}{{#if: {{{2|}}} | {{!}} {{{2}}} |}}{{#if: {{{3|}}} | {{!}} {{{3}}} |}}{{#if: {{{4|}}} | {{!}} {{{4}}} |}}{{#if: {{{5|}}} | {{!}} {{{5}}} |}}{{#if: {{{6|}}} | {{!}} {{{6}}} |}}{{#if: {{{7|}}} | {{!}} {{{7}}} |}}{{#if: {{{8|}}} | {{!}}..."

2023-12-09T23:53:53Z

Created page with "<onlyinclude>{{((}}{{PAGENAME}}{{#if: {{{sub|}}}|/{{{sub}}}|}}{{#if: {{{1|}}} | {{!}} {{{1}}} |}}{{#if: {{{2|}}} | {{!}} {{{2}}} |}}{{#if: {{{3|}}} | {{!}} {{{3}}} |}}{{#if: {{{4|}}} | {{!}} {{{4}}} |}}{{#if: {{{5|}}} | {{!}} {{{5}}} |}}{{#if: {{{6|}}} | {{!}} {{{6}}} |}}{{#if: {{{7|}}} | {{!}} {{{7}}} |}}{{#if: {{{8|}}} | {{!}}..."

New page
<onlyinclude>{{((}}{{PAGENAME}}{{#if: {{{sub|}}}|/{{{sub}}}|}}{{#if: {{{1|}}}
| {{!}} {{{1}}} 
|}}{{#if: {{{2|}}}
| {{!}} {{{2}}} 
|}}{{#if: {{{3|}}}
| {{!}} {{{3}}} 
|}}{{#if: {{{4|}}}
| {{!}} {{{4}}} 
|}}{{#if: {{{5|}}}
| {{!}} {{{5}}} 
|}}{{#if: {{{6|}}}
| {{!}} {{{6}}} 
|}}{{#if: {{{7|}}}
| {{!}} {{{7}}} 
|}}{{#if: {{{8|}}}
| {{!}} {{{8}}} 
|}}{{#if: {{{9|}}}
| {{!}} {{{9}}} 
|}}{{))}}</onlyinclude>

==Purpose==
In an effort to maintain consistent, complete, concise, and coherent documentation for {{Catlink|Templates}}, each template page includes a '''Usage''' section, using this template to demonstrate how to properly utilize that template according to its '''Purpose'''.

==Usage==
In its simplest form, this template can be displayed in-line or on its own line.

{{Usage|parameter1|parameter2|...|parameter9}}

Thus, <code><nowiki>{{Usage|quality|name|description}}</nowiki></code>

becomes {{Usage|quality|name|description}}

To specify a subpage of the template, pass an argument to the named parameter "sub".

{{Usage|sub{{=}}|param1|param2|...}}

===Parameters===
It's often useful to define the parameters for a template. Using {{Usage|sub=Param}}, one can describe each parameter and even specify if it's optional and, if so, its default value.

{{Usage|sub=Param|parameter|description|optional|default}}
{{Usage/Param|parameter|A name for the parameter. If it isn't a named parameter, this is arbitrary.}}
{{Usage/Param|description|A description of the named parameter.}}
{{Usage/Param|optional|If this argument is included, the parameter will be marked "Optional."|optional}}
{{Usage/Param|default|Use this parameter only if "optional" is also specified. This will display what value is used if the parameter isn't given an argument.|optional}}

===Blocks===
For templates with a large number of parameters, or whose arguments are expected to be lengthy, it's best to break them up into several lines. This is especially used for templates that use named parameters so that the undefined ones can be omitted. This also makes it easier to copy, paste, and fill out values. In order to format it consistently, pass the parameters into {{Usage|sub=Block}}. After the parameter descriptions, {{Temlink|Clear}} must always be added to prevent subsequent text from being pushed to the right.

{{Usage|sub=Block|param1|param2|...|param20}}
{{Usage/Param|param1...param20|Each named parameter, up to 20.}}

{{Usage/Example}}
<pre>{{Usage/Block|name|rank|serial}}
{{Usage/Param|name|description}}
{{Usage/Param|rank|description}}
{{Usage/Param|serial|description}}
{{Clear}}</pre>
{{Usage/Result|
{{Usage/Block|name|rank|serial}}
{{Usage/Param|name|description}}
{{Usage/Param|rank|description}}
{{Usage/Param|serial|description}}
{{Clear}}
}}

As with the basic use of {{Temlink|Usage}}, an optional "sub" parameter can be set to specify a subpage. Also, one anonymous parameter can be added by passing a value to "anon", like so:

{{Usage/Example}}
<pre>{{Usage/Block|sub=Deceased|anon=cause
|date|medals|family}}
{{Usage/Param|cause|description}}
{{Usage/Param|date|description}}
{{Usage/Param|medals|description}}
{{Usage/Param|family|description}}
{{Clear}}</pre>
{{Usage/Result|
{{Usage/Block|sub=Deceased|anon=cause
|date|medals|family}}
{{Usage/Param|cause|description}}
{{Usage/Param|date|description}}
{{Usage/Param|medals|description}}
{{Usage/Param|family|description}}
{{Clear}}
}}

===Composites===
Some templates make use of subtemplates to effect more modularity. To demonstrate the use of several templates working together, simply place them in a preformatted box floated to the left, with a description either to the right of or below the box.

{{Usage/Example}}
<pre>{{Float|left|<pre>
{{Several}}
{{Templates}}
</pre>}}
Description
{{Clear|left}}</pre>
{{Usage/Result|
{{Float|left|<pre>
{{Several}}
{{Templates}}
</pre>}}
Description
{{Clear}}
}}

===Examples===
The best way to demonstrate a template may depend on the template itself. For simple one-liners, this is often enough:

<code><nowiki><code><nowiki>{{Template}}</nowiki></code> → {{Template}}</nowiki></code>

Other times it may be necessary to lay out the code and the result in a table. To simplify this, use {{Usage|sub=Example}} and {{Usage|sub=Result}}. Start with {{Usage|sub=Example}}, then wrap the code in <nowiki><pre></nowiki> tags. Finally, copy the code - without the <nowiki><pre></nowiki> tags - as an argument to {{Usage|sub=Result}}.

{{Float|left|<pre>
{{Usage/Example}}
<pre>{{TemplateCode}}</pre>
{{Usage/Result|
{{TemplateCode}}
}}
</pre>}}

Note that {{Usage|sub=Example}} is used by itself with the example code following it, while {{Usage|sub=Result}} takes the result code as an argument.
{{Clear}}

{{Cat|Formatting Templates}}

Template:Usage - Revision history