From The Mana World
(Created page with "{{Documentation |Usage = Show description about when to use the template and code to use in the template page |Code = Documentaion<br/><nowiki>|Usage = Description about when ...")
 
(add: "Translatable" parameter description | minor fixes)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Documentation
{{Documentation
|Usage = Show description about when to use the template and code to use in the template page
  |Description = Use this template in order to create documentation for any template.
|Code = Documentaion<br/><nowiki>|Usage = Description about when to use the template</nowiki><br/><nowiki>|Code = Code to use</nowiki>
  |Usage       = Copy the following code into your template doc page and fill the values:
  |Code       =  
<nowiki>Documentation
  |Description =
  |Usage      =
  |Code        = TemplateName {{!}}arg1=arg1value {{!}}arg2=
  |Params      = {{Parameter|arg1|Arg1 description}}
  {{Parameter|arg2|Arg2 description|Default = "Default value of arg2"}}
  |Translatable= No
</nowiki>
  |Params      = {{Parameter|Description|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="Documentation for the [[{{#titleparts:{{FULLPAGENAME}}|1}}|{{#titleparts:{{PAGENAME}}|1}}]] template."}}
  {{Parameter|Usage|Instructions about how and where to use the template|Default = "Copy the following code into your page:"}}
  {{Parameter|Code|Template sample code, starting with its ''NAME''.
If the template uses args, add default values separated with "<code>[[Template:!|<nowiki>{{!}}</nowiki>]]</code>" 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
}}
}}
  {{Parameter|Params|Parameters description list. The <code>[[Template:Parameter|<nowiki>{{Parameter}}</nowiki>]]</code> template '''must''' to be used in order to describe each parameter| Default = null}}
  {{Parameter|Translatable|Mark documentation as translatable. Displays a menu containing shortcuts links to translated documentation (similar to <code>[[Template:I18n|<nowiki>{{I18n}}</nowiki>]]</code>) if is set to ''"Yes"'' (case insensitive). Any other value, will be ignored| Default = "no"}}
  | Translatable = No yet
}}
Remember, also, categorize it under [[:Category:Template documentation]] by adding this at the end:
<dl style="display:inline-block; padding-left:.75em; margin-left:0;">
<nowiki><noinclude>[[Category:Template documentation]]</noinclude></nowiki>
</dl>
<noinclude>[[Category:Template documentation]]</noinclude>

Latest revision as of 14:02, 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>