Nelson6e65 (talk | contribs) (updated) |
Nelson6e65 (talk | contribs) (add: "Translatable" parameter description | minor fixes) |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
{{Documentation | {{Documentation | ||
|Description = Use this template in order to create documentation for any template. | |Description = Use this template in order to create documentation for any template. | ||
|Usage = Copy the following code into your template doc page and | |Usage = Copy the following code into your template doc page and fill the values: | ||
|Code = | |Code = | ||
<nowiki>Documentation | <nowiki>Documentation | ||
|Description = | |Description = | ||
|Usage = | |Usage = | ||
|Code = | |Code = TemplateName {{!}}arg1=arg1value {{!}}arg2= | ||
|Params = {{Parameter|arg1|Arg1 description}} | |||
{{Parameter|arg2|Arg2 description|Default = "Default value of arg2"}} | |||
|Translatable= No | |||
</nowiki> | </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 | 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;"> | <dl style="display:inline-block; padding-left:.75em; margin-left:0;"> | ||
<nowiki><noinclude>[[Category:Template documentation]]</noinclude></nowiki> | <nowiki><noinclude>[[Category:Template documentation]]</noinclude></nowiki> | ||
</dl> | </dl> | ||
<noinclude>[[Category:Template documentation]]</noinclude> | <noinclude>[[Category:Template documentation]]</noinclude> |
Latest revision as of 14:02, 25 October 2015
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: |
Usage :
|
Optional. Instructions about how and where to use the template.
Default value: |
Code :
|
Required. Template sample code, starting with its NAME.
If the template uses args, add default values separated with " |
Params :
|
Optional. Parameters description list. The {{Parameter}} template must to be used in order to describe each parameter.
Default value: |
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: |
Remember, also, categorize it under Category:Template documentation by adding this at the end:
-
<noinclude>[[Category:Template documentation]]</noinclude>