Help:Templates - Revision history

imported>Admin: adding commonly used templates link

2008-02-21T03:31:31Z

adding commonly used templates link

← Older revision		Revision as of 03:31, 21 February 2008
(No difference)

imported>Admin: adding commonly used templates link

2008-02-21T03:31:31Z

adding commonly used templates link

← Older revision		Revision as of 03:31, 21 February 2008
Line 59:		Line 59:
	Finally, your usage section should include <tt><nowiki>[[Category: Templates]]</nowiki></tt>. That way, all templates are listed together in the category for easy reference.		Finally, your usage section should include <tt><nowiki>[[Category: Templates]]</nowiki></tt>. That way, all templates are listed together in the category for easy reference.
	[[Category: Help]]		[[Category: Help]]

			==Commonly Used Templates==
			A list of commonly used templates may be found [[Help:Common templates\|here]].

imported>Hardvice: rem tocright -- standard for articles with sidebars

2007-03-18T06:03:52Z

rem tocright -- standard for articles with sidebars

← Older revision		Revision as of 06:03, 18 March 2007
Line 2:		Line 2:
	{{helpbox}}		{{helpbox}}
	'''Templates''' are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.		'''Templates''' are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.
	{{tocright}}
	==Using Templates==		==Using Templates==
	To include a template in a page, enter <tt><nowiki>{{name_of_template}}</nowiki></tt> in the page where you would like to include the template. If a template accepts variables, enter them using a pipe, the name of the variable (if any), an equals sign, and the text you wish to use. For example, <tt><nowiki>{{template\|text=your_text_here}}</nowiki></tt> would insert the template "template" and set the variable "text" to "your text here".		To include a template in a page, enter <tt><nowiki>{{name_of_template}}</nowiki></tt> in the page where you would like to include the template. If a template accepts variables, enter them using a pipe, the name of the variable (if any), an equals sign, and the text you wish to use. For example, <tt><nowiki>{{template\|text=your_text_here}}</nowiki></tt> would insert the template "template" and set the variable "text" to "your text here".

imported>Hardvice: +helpbox

2007-03-18T03:14:50Z

+helpbox

← Older revision		Revision as of 03:14, 18 March 2007
Line 1:		Line 1:
	__NOEDITSECTION__		__NOEDITSECTION__
	{{~~tocright~~}}		{{helpbox}}
	'''Templates''' are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.		'''Templates''' are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.
			{{tocright}}

	==Using Templates==		==Using Templates==
	To include a template in a page, enter <tt><nowiki>{{name_of_template}}</nowiki></tt> in the page where you would like to include the template. If a template accepts variables, enter them using a pipe, the name of the variable (if any), an equals sign, and the text you wish to use. For example, <tt><nowiki>{{template\|text=your_text_here}}</nowiki></tt> would insert the template "template" and set the variable "text" to "your text here".		To include a template in a page, enter <tt><nowiki>{{name_of_template}}</nowiki></tt> in the page where you would like to include the template. If a template accepts variables, enter them using a pipe, the name of the variable (if any), an equals sign, and the text you wish to use. For example, <tt><nowiki>{{template\|text=your_text_here}}</nowiki></tt> would insert the template "template" and set the variable "text" to "your text here".

imported>Hardvice: +noeditsection, +tocright

2006-11-30T20:48:59Z

+noeditsection, +tocright

← Older revision		Revision as of 20:48, 30 November 2006
Line 1:		Line 1:
			__NOEDITSECTION__
⚫	Templates are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.
			{{tocright}}
		⚫	'''Templates''' are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.

	==Using Templates==		==Using Templates==

imported>Hardvice: /* The Usage Section */ escape comment tag example

2006-11-29T03:53:18Z

The Usage Section: escape comment tag example

← Older revision		Revision as of 03:53, 29 November 2006
Line 54:		Line 54:
	</pre>		</pre>

	Note that the explanations of the variables are enclosed in comment tags (<tt><!-- --></tt>). That way, if an editor forgets to remove your default text when pasting in the template, your default won't accidentally appear in the article.		Note that the explanations of the variables are enclosed in comment tags (<tt><!-- --></tt>). That way, if an editor forgets to remove your default text when pasting in the template, your default won't accidentally appear in the article.

	Finally, your usage section should include <tt><nowiki>[[Category: Templates]]</nowiki></tt>. That way, all templates are listed together in the category for easy reference.		Finally, your usage section should include <tt><nowiki>[[Category: Templates]]</nowiki></tt>. That way, all templates are listed together in the category for easy reference.

imported>Hardvice: /* Markup for inclusion */ omitted an article

2006-11-10T05:00:53Z

Markup for inclusion: omitted an article

← Older revision		Revision as of 05:00, 10 November 2006
Line 18:		Line 18:
	Some special Wiki markup controls how the text you add to a template article will be treated when the template is included.		Some special Wiki markup controls how the text you add to a template article will be treated when the template is included.

	* <tt><nowiki><noinclude></nowiki></tt>: Any text between the tags will appear in template's article but not be included when the template is added to pages. Useful for assigning category to the template but not the article or for typing usage notes for the template.		* <tt><nowiki><noinclude></nowiki></tt>: Any text between the tags will appear in the template's article but not be included when the template is added to pages. Useful for assigning category to the template but not the article or for typing usage notes for the template.
	* <tt><nowiki><includeonly></nowiki></tt>: Any text between the tags will appear in when the template is added to an article but not in the template's page itself. Useful for assigning category to the article but not to the template.		* <tt><nowiki><includeonly></nowiki></tt>: Any text between the tags will appear in when the template is added to an article but not in the template's page itself. Useful for assigning category to the article but not to the template.

imported>Hardvice at 20:38, 9 November 2006

2006-11-09T20:38:09Z

New page

Templates are used to create special formatting or consistent elements in articles. Templates allow formatting changes to be made to the template, and automatically have those changes reflected in all articles which include that template.

==Using Templates==
To include a template in a page, enter <tt><nowiki>{{name_of_template}}</nowiki></tt> in the page where you would like to include the template. If a template accepts variables, enter them using a pipe, the name of the variable (if any), an equals sign, and the text you wish to use. For example, <tt><nowiki>{{template|text=your_text_here}}</nowiki></tt> would insert the template "template" and set the variable "text" to "your text here".

For usage notes for a particular template, including any variables, see each [[:Category:Templates|template's article]].

==Includes==
You can also include an article as if it were a template by placing the article's name, preceded by a colon, in double braces. For example, typing <tt><nowiki>{{:Niki Sanders}}</nowiki></tt> would insert the text of Niki's article into the article you are editing. If Niki's article is changed, the changes will be automatically reflected on the page in which it is included.

==Substitutions==
Finally some templates are meant to be substituted. A substituted template copies the template's text into the article as text, not as a reference back to the template. It basically just 'pastes' the content of the template into the article. To substitute a template, enter <tt><nowiki>{{subst:template_name}}</nowiki></tt> and hit "save page". When the edit is completed, the text from the template will appear in the article.

==Adding a Template==
To add a template, create it just like any other article, but be sure to name it with the <tt>Template:</tt> namespace.

===Markup for inclusion===
Some special Wiki markup controls how the text you add to a template article will be treated when the template is included.

* <tt><nowiki><noinclude></nowiki></tt>: Any text between the tags will appear in template's article but not be included when the template is added to pages. Useful for assigning category to the template but not the article or for typing usage notes for the template.
* <tt><nowiki><includeonly></nowiki></tt>: Any text between the tags will appear in when the template is added to an article but not in the template's page itself. Useful for assigning category to the article but not to the template.

===Variables===
Templates can use variables, either specific to the template or global.

====Template-specific Variables====
Enclose variables in triple braces where you would like them to appear in the included template. Be sure to list and explain any variables in the Usage section so other editors will know what variables they can feed to the template. Be mindful of capitalization and spelling of variables to make sure your template functions properly.

====Global Variables====
Global variables are a little different. Basically, they are system-defined templates that can be used in any article. You can use global variables to insert things like the current page's name, the date and time, or the total number of articles. They are used like templates—that is, in ''double'' braces rather than triple braces. For a complete list of available global variables, see [http://en.wikipedia.org/wiki/Help:Variable Wikipedia Help: Variables].

===Conditionals===
Templates (and other articles) can make use of a set of special templates called conditionals. A conditional tests whether a specified condition exists and then displays different text based on the result. For example, in a template you can use a conditional to see if the editor has specified a particular variable in the template call. If they have, you can print the appropriate information. If not, you can skip the info or print a different default message.

To use a conditional, enclose it in double braces. Pipe each value required by the conditional. Insert a pipe at the end of any variables you are testing. For example
<pre>{{#if: {{{image|}}} | [[Image:{{{image}}}]] | No Image Available}}</pre>
checks to see if the template call specified a value for <tt>image</tt>. If it finds one, it prints the image. If it does not, it prints "No Image Available" instead.

For a list of all available conditions, as well as more detailed help, please see [http://meta.wikimedia.org/wiki/ParserFunctions WikiMedia Help:ParserFunctions].

===The Usage Section===
Be sure to add a usage section to your template so others will know how to use your template. Begin you usage section with a <tt><noinclude></tt> tag to prevent it from being included in articles which call the template. The <tt><noinclude></tt> tag should be placed ''immediately after'' the text of your template with no line breaks or spaces; otherwise, the additional formatting ''will'' be included when the template is called.

After the tag, break the line and add a section heading for Usage. Explain what your template does, and any special properties it has (such as clearing floated images or adding categories when it is included).

You should then give an example of use. Put this inside a pair of <tt><pre></tt> tags. This will preserve formatting, prevent the wiki markup from being executed, and allow users to cut and paste the blank example of your template. A completed example should look like this:

<pre>{{Tim's Template
| Name = 
| Quest = 
| Favorite Color = 
| Airspeed = 
}}
</pre>

Note that the explanations of the variables are enclosed in comment tags (<tt></tt>). That way, if an editor forgets to remove your default text when pasting in the template, your default won't accidentally appear in the article.

Finally, your usage section should include <tt><nowiki>[[Category: Templates]]</nowiki></tt>. That way, all templates are listed together in the category for easy reference.
[[Category: Help]]