Template:Documentation/doc: Difference between revisions
sims>Duskey m (added category) |
sims>K6ka (Created page with " ==Description== This template is used to insert descriptions on template pages. ==Syntax== Add <code><nowiki><noinclude></nowiki>{{t|documentation}}<nowiki></noinclude></now...") |
||
Line 1: | Line 1: | ||
{{#ifexist: Template:Documentation/preload | <!-- nothing; preload already copied --> | :<strong class="error">Please copy <nowiki>{{Documentation}}</nowiki>'s preload template from [[w:c:templates:Template:Documentation/preload]] to [[Template:Documentation/preload]]!</strong>}}<!-- |
|||
-->{{#ifexist: Template:T | <!-- nothing; T already copied/exists --> | :<strong class="error">Please copy <nowiki>{{T}}</nowiki> from [[w:c:templates:Template:T]] to [[Template:T]]!</strong>}}<!-- |
|||
-->{{#ifexist: Template:T/doc | <!-- nothing; T's documentation already copied/exists --> | :<strong class="error">Please copy <nowiki>{{T}}</nowiki>'s documentation from [[w:c:templates:Template:T/doc]] to [[Template:T/doc]]!</strong>}}<!-- |
|||
-->{{#ifexist: Template:Tocright | <!-- nothing; Tocright already copied/exists --> | :<strong class="error">Please copy <nowiki>{{Tocright}}</nowiki> from [[w:c:templates:Template:Tocright]] to [[Template:Tocright]]!</strong>}}<!-- |
|||
-->{{#ifexist: Template:Tocright/doc | <!-- nothing; Tocright's documentation already copied/exists --> | :<strong class="error">Please copy <nowiki>{{Tocright}}</nowiki>'s documentation from [[w:c:templates:Template:Tocright/doc]] to [[Template:Tocright/doc]]!</strong>}} |
|||
;Description |
|||
⚫ | |||
⚫ | |||
⚫ | |||
== |
==Description== |
||
⚫ | |||
⚫ | |||
⚫ | |||
==Usage== |
|||
===On the Template page=== |
===On the Template page=== |
||
This is the normal format when used: |
|||
<pre> |
<pre> |
||
TEMPLATE CODE<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude> |
|||
{{documentation}}</noinclude> |
{{documentation}}</noinclude> |
||
</pre> |
</pre> |
||
''If your template is not a completed div or table, you may need to close the tags just before <code><nowiki>{{documentation}}</nowiki></code> is inserted (within the noinclude tags).'' |
|||
''A line break right before <code><nowiki>{{documentation}}</nowiki></code> can also be useful as it helps prevent the documentation template "running into" previous code.'' |
|||
===On the Template/doc page=== |
===On the Template/doc page=== |
||
Normally, you will want to write something like the following on the documentation page: |
|||
:''See also [[Template:Documentation/preload]]'' |
|||
<pre> |
<pre> |
||
==Description== |
|||
This template is used to do something. |
|||
==Syntax== |
|||
Type <code>{{t|templatename}}</code> somewhere. |
|||
;Sample output |
|||
⚫ | |||
==Samples== |
|||
⚫ | |||
⚫ | |||
results in... |
|||
⚫ | |||
<includeonly>Any categories for the template itself</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude> |
<includeonly>Any categories for the template itself</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude> |
||
</pre> |
</pre> |
||
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or |
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or other sections. |
||
⚫ | |||
⚫ | |||
⚫ | |||
<includeonly> |
|||
[[Category:Template documentation| {{PAGENAME}}]] |
|||
[[Category:General wiki templates|{{PAGENAME}}]]</includeonly><noinclude> |
|||
⚫ |
Revision as of 22:01, 11 May 2017
Description
This template is used to insert descriptions on template pages.
Syntax
Add <noinclude>{{documentation}}</noinclude>
at the end of the template page.
Usage
On the Template page
This is the normal format when used:
TEMPLATE CODE<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude> {{documentation}}</noinclude>
If your template is not a completed div or table, you may need to close the tags just before {{documentation}}
is inserted (within the noinclude tags).
A line break right before {{documentation}}
can also be useful as it helps prevent the documentation template "running into" previous code.
On the Template/doc page
Normally, you will want to write something like the following on the documentation page:
==Description== This template is used to do something. ==Syntax== Type <code>{{t|templatename}}</code> somewhere. ==Samples== <code><nowiki>{{templatename|input}}</nowiki></code> results in... {{templatename|input}} <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 other sections.
Note that the above example also uses the Template:T and Template:T/piece templates.