Template:Documentation/doc: Difference between revisions

From Screamer Wiki
Jump to: navigation, search
imported>Default
(Removed: <includeonly>Any categories for the template itself</includeonly> - This does not work correctly. License tags are not showing up at Category:Image wiki templates)
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)
Line 31: Line 31:


Note that the above example also uses the [[Template:T]] and [[Template:T/piece]] templates.
Note that the above example also uses the [[Template:T]] and [[Template:T/piece]] templates.
Adding
<pre>
<nowiki><includeonly>Any categories for the template itself</includeonly></nowiki>
</pre>
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 ''<nowiki><noinclude></noinclude></nowiki>''


<includeonly>[[Category:General wiki templates|{{PAGENAME}}]]</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
<includeonly>[[Category:General wiki templates|{{PAGENAME}}]]</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

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}}</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>