Huyie at 14:03, 26 July 2013

2013-07-26T14:03:03Z

Huyie at 13:00, 26 July 2013

2013-07-26T13:00:32Z

Huyie: Created page with "{{Documentation subpage}} ===Purpose=== This is the {{tl|documentation}} template. It is intended for documenting templates and other pages which are transcluded onto other pa..."

2013-07-26T12:56:41Z

Created page with "{{Documentation subpage}} ===Purpose=== This is the {{tl|documentation}} template. It is intended for documenting templates and other pages which are transcluded onto other pa..."

New page

{{Documentation subpage}}
===Purpose===
This is the {{tl|documentation}} template. It is intended for documenting templates and other pages which are transcluded onto other pages. Using this template allows templates to be made read-only where necessary, while allowing anyone to edit the documentation and categories.

This template displays a coloured text box like you are seeing now, and automatically loads the content from a /doc subpage or other places. The idea and the usage of this template was adopted from Wikipedia. For most of the instructions about how and when to use this template, see Wikipedia's article on [[Wikipedia:WP:DOC|template documentation]].

===Usage===
In most cases this template is used without any parameters, placed at the bottom of the template or page being documented, within <code><noinclude></code> tags:

<pre>
<noinclude>
{{documentation}}

</noinclude>
</pre>

Then this template automatically loads the content from the /doc subpage of the template it is used on.

This template can also load the content from any other page. Like this:

<pre>
<noinclude>
{{documentation|Template:Other page/doc}}
</noinclude>
</pre>

===Best practice===
The {{tl|documentation}} tag should be added at the bottom of the template code, with no space before <code><noinclude></code> (which would cause extra space on pages where the template is used).

Categories that apply to the template itself should be added to the bottom of the /doc subpage, inside <code><includeonly>...</includeonly></code> tags.

The Categorization of the template its documentation and of the pages that use the template works as follows:
*'''To place the template itself into a category''', add the <code><nowiki>[[Category:Category name]]</nowiki></code> code inside an <code><nowiki><includeonly></nowiki></code>...<code><nowiki></includeonly></nowiki></code> section on the /doc subpage.
*'''To place the /doc subpage into a category''', add the <code><nowiki>[[Category:Category name]]</nowiki></code> code inside a <code><nowiki><noinclude></nowiki></code>...<code><nowiki></noinclude></nowiki></code> section on the /doc subpage.
*'''To make the template place an article into a category''' (when the article includes the template), add the <code><nowiki>[[Category:Category name]]</nowiki></code> code inside an <code><nowiki><includeonly></nowiki></code>...<code><nowiki></includeonly></nowiki></code> section on the template page.

'''Note:''' This template is a much less complex version of the Wikipedia template. We support only the parameters described here. Some convenience and customization functions, as well as support for sandbox and testcases are not available here.

===See also===
*Wikipedia article on [[Wikipedia:WP:DOC|template documentation]]
*{{tl|Documentation subpage}} – Infobox that explains that what follows is documentation, and links to the documented page
*[[MetaWikiPedia:Help:Templates#Noinclude, includeonly, and onlyinclude|<nowiki><noinclude> and <includeonly></nowiki> tags]] explained on Meta-Wiki

<includeonly>
[[Category:Formatting Templates]]
[[Category:Function Templates]]
</includeonly>

← Older revision		Revision as of 14:03, 26 July 2013
Line 45:		Line 45:
	[[Category:Templates]]		[[Category:Templates]]
	</includeonly>		</includeonly>
		+
		+	<noinclude>
		+	[[Category:Documentation pages]]
		+	</noinclude>

@@ Line 43: / Line 43: @@
 <includeonly>
-[[Category:Formatting Templates]]
+[[Category:Templates]]
 </includeonly>

Template:Documentation/doc - Revision history

Huyie at 14:03, 26 July 2013

Huyie at 13:00, 26 July 2013

Huyie: Created page with "{{Documentation subpage}} ===Purpose=== This is the {{tl|documentation}} template. It is intended for documenting templates and other pages which are transcluded onto other pa..."