Template:Documentation/doc: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(This revision and previous are available under: CC BY-SA 3.0. See list of authors in previous history below.)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
;Description
:This template is used to insert descriptions on template pages.
;Syntax
:Type <code>&lt;noinclude&gt;{{t|documentation}}&lt;/noinclude&gt;</code> at the top of the template page or <code>&lt;onlyinclude&gt;''Template code''&lt;/onlyinclude&gt;{{t|documentation}}</code>.
;See also
* {{t|Documentation2}} - for documenting template-like page in the main namespace.
==General usage==
===On the Template page===
<pre><noinclude>{{documentation}}
</noinclude>Template code
<includeonly>Categories applied to pages using the template</includeonly>
</pre>


The line break before <code>&lt;includeonly&gt;</code> is included here for formatting purposes, and should not appear in actual templates. Depending on the template, it may be beneficial to move the <code>&lt;includeonly&gt;</code> to immediately after <code>&lt;/noinclude&gt;</code>, hiding the template from view.
OR
<pre>{{documentation}}
<onlyinclude>Template code</onlyinclude>
<includeonly>Categories applied to pages using the template</includeonly>
</pre>
===On the Template/doc page===
<pre>
;Description
:This template is used to do something.
;Syntax
:Type <code>{{t|templatename}}</code> somewhere.
;Sample output
:<code>&lt;nowiki&gt;{{templatename|foo}}&lt;/nowiki&gt;</code> gives...
:{{templatename|foo}}
<includeonly>Any categories for the template itself</includeonly>
<noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
</pre>
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.
==Non-Template namespace usage==
===On the Template page===
<pre><noinclude>{{documentation|ns=User}}
</noinclude>Template code
<includeonly>Categories applied to pages using the template</includeonly>
</pre>
The line break before <code>&lt;includeonly&gt;</code> is included here for formatting purposes, and should not appear in actual templates. Depending on the template, it may be beneficial to move the <code>&lt;includeonly&gt;</code> to immediately after <code>&lt;noinclude&gt;</code>, hiding the template from view.
<includeonly>[[Category:General wiki templates|{{PAGENAME}}]]
[[ru:Шаблон:Документация]]</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

Latest revision as of 13:36, 9 September 2014

Description
This template is used to insert descriptions on template pages.
Syntax
Type <noinclude>{{documentation}}</noinclude> at the top of the template page or <onlyinclude>Template code</onlyinclude>{{documentation}}.
See also
  • {{Documentation2}} - for documenting template-like page in the main namespace.

General usage[edit]

On the Template page[edit]

<noinclude>{{documentation}}
</noinclude>Template code
<includeonly>Categories applied to pages using the template</includeonly>

The line break before <includeonly> is included here for formatting purposes, and should not appear in actual templates. Depending on the template, it may be beneficial to move the <includeonly> to immediately after </noinclude>, hiding the template from view.

OR

{{documentation}}
<onlyinclude>Template code</onlyinclude>
<includeonly>Categories applied to pages using the template</includeonly>

On the Template/doc page[edit]

;Description
:This template is used to do something.
;Syntax
:Type <code>{{t|templatename}}</code> somewhere.
;Sample output
:<code>&lt;nowiki&gt;{{templatename|foo}}&lt;/nowiki&gt;</code> gives...
:{{templatename|foo}}

<includeonly>Any categories for the template itself</includeonly>
<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.

Non-Template namespace usage[edit]

On the Template page[edit]

<noinclude>{{documentation|ns=User}}
</noinclude>Template code
<includeonly>Categories applied to pages using the template</includeonly>

The line break before <includeonly> is included here for formatting purposes, and should not appear in actual templates. Depending on the template, it may be beneficial to move the <includeonly> to immediately after <noinclude>, hiding the template from view.