From The Mana World
(improve styles)
(Rename param: "Translate" --> Translatable)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>
<includeonly><div style="padding-bottom:3px;margin-bottom:1ex">
<div style="padding-bottom:3px;border-bottom:1px solid #aaa;margin-bottom:1ex"><span style="font-weight:bold;font-size:150%">[[File:50px-Template-info.png]] Template documentation</span></div>  
<span style="font-weight:bold;font-size:150%">[[File:50px-Template-info.png]] Template documentation</span>
<span class="plainlinks"><sup>[ [{{canonicalurl:{{FULLPAGENAME}}/doc|action=edit}} Edit] ]</sup></span>
{{#ifeq: {{lc:{{{Translatable| no }}} }} | yes | {{Documentation/i18n}} }}
</div>


{{{Description|Description about when to use the template.}}}
===Description===__NOEDITSECTION__
{{{Description|Documentation for the [[{{#titleparts:{{FULLPAGENAME}}|1}}|{{#titleparts:{{PAGENAME}}|1}}]] template.}}}


===Usage===
===Usage===__NOEDITSECTION__
{{{Usage|Copy the following code into your page:}}}
{{{Usage|Copy the following code into your page:}}}


Line 11: Line 15:
</dl>
</dl>


{{#if:{{{Params|o}}}
{{#if:{{{Params|}}}
   |===Parameters===
   |===Parameters===__NOEDITSECTION__
{{{Params}}}  
List of parameters used by this template:
{{Parameters container
  |{{{Params}}}
}}
}}
</includeonly>
}}
<noinclude>{{:Template:{{PAGENAME}}/doc}}    <!-- this is to include documentation in this page, without transcluding it in the page where template is used -->
</includeonly><noinclude>{{:Template:{{PAGENAME}}/doc}}    <!-- this is to include documentation in this page, without transcluding it in the page where template is used -->
[[Category:General Template]]        <!-- this is to categorize the template. It will not be transcluded in the page where template is used -->
[[Category:General Template]]        <!-- this is to categorize the template. It will not be transcluded in the page where template is used -->
</noinclude>
</noinclude>

Latest revision as of 13:25, 25 October 2015

50px-Template-info.png Template documentation [ Edit ]

Description

Use this template in order to create documentation for any template.

Usage

Copy the following code into your template doc page and fill the values:

{{Documentation |Description = |Usage = |Code = TemplateName {{!}}arg1=arg1value {{!}}arg2= |Params = {{Parameter|arg1|Arg1 description}} {{Parameter|arg2|Arg2 description|Default = "Default value of arg2"}} |Translatable= No }}

Parameters

List of parameters used by this template:

Description: Optional. Description about what does the template and when to use it. If empty, it will be used a generic text with the template link (generated dynamically).

Default value: "Documentation for the Documentation template."

Usage: Optional. Instructions about how and where to use the template.

Default value: "Copy the following code into your page:"

Code: Required. Template sample code, starting with its NAME.

If the template uses args, add default values separated with "{{!}}" between each one (inline form). If there is to many args, you should use the nowiki tag for multiline. Do not add the starting/ending braces. You should fill the params values with useful content that makes easy the edition .

Params: Optional. Parameters description list. The {{Parameter}} template must to be used in order to describe each parameter.

Default value: null

Translatable: Optional. Mark documentation as translatable. Displays a menu containing shortcuts links to translated documentation (similar to {{I18n}}) if is set to "Yes" (case insensitive). Any other value, will be ignored.

Default value: "no"


Remember, also, categorize it under Category:Template documentation by adding this at the end:

<noinclude>[[Category:Template documentation]]</noinclude>