Template:Documentation/doc: Difference between revisions
imported>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) |
imported>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 12:30, 13 June 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>