8,161
edits
Difference between revisions of "Lylat Wiki:Template Standards"
updated
(updated) |
|||
| (19 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{shortcuts|LW:TS}} | |||
{{Standards}} | {{Standards}} | ||
Templates are used to make it easier on a page to store | {{draft-policy}} | ||
Templates are used to make it easier on a page to store information, as some of the information is stored elsewhere. Templates are used to make it easier on the editors, as to provide a common content and save time instead of placing the exact same content in different locations. Templates are also used as tools to help direct community involvement for the maintenance of an article. But what makes a "Good Template"? | |||
While there will never be an absolute way to say "this is a good template", there are certain things we should expect from each template and there respective pages (such as documentation and usage information). Due to the nature and infinitely diverse uses of templates, having a common expectation for each page does help standardize the pages. | While there will never be an absolute way to say "this is a good template", there are certain things we should expect from each template and there respective pages (such as documentation and usage information). Due to the nature and infinitely diverse uses of templates, having a common expectation for each page does help standardize the pages. | ||
| Line 17: | Line 19: | ||
Section headers <nowiki>===</nowiki>), then that section header is not only subject to these guidelines, but also to the guidelines that the receiving page(s) are under. | Section headers <nowiki>===</nowiki>), then that section header is not only subject to these guidelines, but also to the guidelines that the receiving page(s) are under. | ||
For more, please see: [[Lylat Wiki:Section | For more, please see: [[Lylat Wiki:Section Standards]]. | ||
=== Tables === | === Tables === | ||
=== Categories === | |||
Which category does this template belong to? Will it play well with similar templates, sorting itself into place? | |||
Typically, one template will be a member of two templates, both of which are an [[LW:Area|area of the wiki]]. To help decide what the template should be sorted under, we've come up with the template: {{t|cat}}. With this template, a page automatically becomes a member of up to five categories, each one serving as the others sortkey. For more information, see [[Help:Categories]]. | |||
Here are some examples of template categories you may consider putting your template under: | |||
* [[:Category:Article Templates]] | |||
* [[:Category:Category Templates]] | |||
* [[:Category:Character Templates]] | |||
* [[:Category:Color Templates]] | |||
* [[:Category:Company Templates]] | |||
* [[:Category:Discussion Templates]] | |||
* [[:Category:Featured Templates]] | |||
* [[:Category:File Templates]] | |||
* [[:Category:Infobox Templates]] | |||
* [[:Category:Notice Templates]] | |||
* [[:Category:Stage Templates]] | |||
== Documentation == | == Documentation == | ||
| Line 28: | Line 49: | ||
On the actual documentation page, we recommend you put the following: | On the actual documentation page, we recommend you put the following: | ||
* a Documentation Shell, which is intended to provide easier access to the template page, the name of the template, and related templates. | * a Documentation Shell, which is intended to provide easier access to the template page, the name of the template, and related templates. | ||
* The | * The two sections: Purpose and Usage. | ||
=== Documentation Shell === | === Documentation Shell === | ||
{{templates-table-top}} | {{templates-table-top}} | ||
|- | |- | ||
| [[Template:documentation shell|documentation shell]] | | [[Template:documentation shell|documentation shell]] | ||
| Line 52: | Line 72: | ||
==Purpose== | ==Purpose== | ||
==Usage== | ==Usage== | ||
===Example=== | |||
<pre> | |||
{{Template Name | |||
| param 1 = | |||
| param 2 = | |||
| param 3 = | |||
}} | |||
</pre> <!-- note: use an actual less than sign than the html equailavent &lt; --> | |||
=== Parameters === | === Parameters === | ||
{{Parameters-table-top}} | {{Parameters-table-top}} | ||
| Line 63: | Line 92: | ||
{{parameters-table-bottom}} | {{parameters-table-bottom}} | ||
|} | |} | ||
<noinclude>[[Category:Documentation|{{PAGENAME}}]]</noinclude></pre> | |||
== Discussions == | == Discussions == | ||
| Line 89: | Line 101: | ||
=== Shortcuts === | === Shortcuts === | ||
=== Maintenance === | === Maintenance === | ||
[[Category:Templates|{{PAGENAME}}]] | |||