Template:Documentation/doc: Difference between revisions

m
12 revisions imported: Import from https://sims.wikia.com
sims>Duskey
m (added category)
m (12 revisions imported: Import from https://sims.wikia.com)
 
(5 intermediate revisions by 2 users not shown)
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
:This template is used to insert documentation on template pages.
;Syntax
:Type <code>&lt;noinclude>{{t|documentation}}&lt;/noinclude></code> at the end of the template page.
 
==General usageDescription==
:This template is used to insert documentationdescriptions on template pages.
 
;==Syntax==
:TypeAdd <code>&lt;<nowiki><noinclude></nowiki>{{t|documentation}}&lt;<nowiki></noinclude></nowiki></code> at the end of the template page.
 
==Usage==
 
===On the Template page===
This is the normal format when used:
 
<pre>
TemplateTEMPLATE codeCODE<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude>
{{documentation}}</noinclude>
Any categories for the template itself</noinclude>
</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===
Normally, you will want to write something like the following on the documentation page:
:''See also [[Template:Documentation/preload]]''
 
<pre>
;Description
:This template is used to do something.
;Syntax
:Type <code>{{t|templatename}}</code> somewhere.
;Sample output
:<code>&lt;nowiki>{{templatename|foo}}</nowiki></code> gives...
:{{templatename|foo}}
 
;==Description==
<includeonly>Any categories for the template itself</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
:This template is used to do something.
 
;==Syntax==
:Type <code>{{t|templatename}}</code> somewhere.
 
==Samples==
:<code>&lt;nowiki>{{templatename|fooinput}}<&lt;/nowiki></code> gives...
 
results in...
 
:{{templatename|fooinput}}
 
<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 informationother sections.
 
Note that the above example also uses {{t|the [[Template:T}}]] and [[Template:T/piece]] templates.
 
{{Important note|When beginning a /doc page with a heading, remember to add a line break between the start of the page and the first heading. Failing to do otherwise may break the heading, resulting in the raw wikitext of the heading being displayed.}}
 
==Credits==
This template's code was taken from [[wikia:w:c:k6ka:Template:Documentation|Template:Documentation]] on K6ka's Wiki on Wikia.
 
<noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
Note that the above example also uses {{t|T}}.
<includeonly>
[[Category:Template documentation| {{PAGENAME}}]]
[[Category:General wiki templates|{{PAGENAME}}]]</includeonly><noinclude>
[[Category:Template documentation|{{PAGENAME}}]]</noinclude>