Templates Wiki
(Undo revision 6979 by Antiedman (talk) - pseudoheader)
(→‎Sample pages: {{Documentation}} has cleared floating content on its own for a few months now; add note about its preload link)
Line 15: Line 15:
 
</pre>
 
</pre>
   
Note that, depending on the template, you may need to add a clear or complete a table/div just before <code><nowiki>{{documentation}}</nowiki></code> is inserted (within the noinclude tags).
+
Note that, depending on the template, you may need to close a table or div tag just before {{t|documentation}} is inserted (within the noinclude tags).
   
The line break is also useful as it helps prevent the documentation template "running into" previous code.
+
The line break is also useful as it helps visually separate the documentation template code from previous code.
   
   
Line 32: Line 32:
 
<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>
  +
  +
You can also click on the "writing some" link in the message "This template currently doesn't have any documentation! Help out by writing some." (displayed by {{t|Documentation}} if no documentation has been written yet), which will give you a [[Template:Documentation/preload|preload]] that you can then fill out.
   
 
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.
 
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.

Revision as of 19:31, 22 November 2010

This article covers the general layout for a standard template page on Wikia.

Procedure

Put the template code on the main page, and put all documentation and categories on a /doc subpage.

This means that updates to the documentation do not result in large numbers of pointless template updates across the wiki, and the template itself can be protected if necessary (without protecting the documentation).

Sample pages

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 close a table or div tag just before {{documentation}} is inserted (within the noinclude tags).

The line break is also useful as it helps visually separate the documentation template code from previous code.


Template/doc page
;Description
:This template is used to do something.
;Syntax
:Type <code>{{t|templatename}}</code> somewhere.
;Sample output
:<code>{{templatename|foo}}</code> gives...
:{{templatename|foo}}

<includeonly>Any categories for the template itself</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

You can also click on the "writing some" link in the message "This template currently doesn't have any documentation! Help out by writing some." (displayed by {{Documentation}} if no documentation has been written yet), which will give you a preload that you can then fill out.

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 template.

Templates used by this layout

Be sure to add these so the template coding will work properly.