Template:Documentation/doc: Difference between revisions
>Default (→On the Template/doc page: Explained inconsistentcy of category placement. I can not start the discussion page here. So please contact me at http://cannabis.wikia.com/wiki/User:Timeshifter) |
>Default (→On the Template page: Inconsistency solution. Put category on template page itself. "Any categories for the template itself" placed between the noinclude tags.) |
||
| Line 8: | Line 8: | ||
<pre> | <pre> | ||
Template code<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude> | Template code<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude> | ||
{{documentation}}</noinclude> | {{documentation}}Any categories for the template itself</noinclude> | ||
</pre> | </pre> | ||
Revision as of 20:46, 26 May 2015
- Description
- This template is used to insert descriptions on template pages.
- Syntax
- Type
<noinclude>{{documentation}}</noinclude>at the end of the template page.
General usage
On the Template page
Template code<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude>
{{documentation}}Any categories for the template itself</noinclude>
Note that, depending on the template, you may need to add a clear or complete a table/div just before {{documentation}} is inserted (within the noinclude tags).
The line break is also useful as it helps prevent the documentation template "running into" previous code.
On the Template/doc page
;Description
:This template is used to do something.
;Syntax
:Type <code>{{t|templatename}}</code> somewhere.
;Sample output
:<code><nowiki>{{templatename|foo}}</nowiki></code> gives...
:{{templatename|foo}}
<noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or further usage information sections.
Note that the above example also uses the Template:T and Template:T/piece templates.
Adding
<includeonly>Any categories for the template itself</includeonly>
does not seem to work consistently at getting the template itself to show up in a category. It works for some templates, and not for others. This may be a bug. So it is better to add the template category to the template page itself. Use <noinclude></noinclude>