Help:Wiki template: Difference between revisions

From COLLADA Public Wiki
Jump to navigation Jump to search
Elf (talk | contribs)
Template usage: spaces for readability
Elf (talk | contribs)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{HelpTOC}}
This wiki software allows us to define '''templates''', which are the same concept as '''macros''' in some languages.  
This wiki software allows us to define '''templates''', which are the same concept as '''macros''' in some languages.  


Line 11: Line 12:
When editing an article,  you include templates using double braces around the template's name, like this:
When editing an article,  you include templates using double braces around the template's name, like this:
   <nowiki>{{needswork}}</nowiki>
   <nowiki>{{needswork}}</nowiki>
or like this:
or like this, if the template allows named arguments:
   <nowiki>{{plug-in | name = My Plug In | web = http://www.mycompany.com | version = 1.4}}</nowiki>
   <nowiki>{{plug-in | name = My Plug In | web = http://www.mycompany.com | version = 1.4}}</nowiki>


Line 30: Line 31:
  <nowiki>*'''Current released version:''' {{{version}}}</nowiki>
  <nowiki>*'''Current released version:''' {{{version}}}</nowiki>


==Complexities==
==Advanced features==
There are additional features that are useful in templates, including
You can use special markup for:
*Predefined variables that do such things as calculate the name of the current article.
*Things that appear only in the template definition page but not where the template occurs (<nowiki><noinclude>...</noinclude></nowiki>).
*Special markup to have things appear only in the template definition page but not where the template occurs, or vice-versa.
*Vice-versa (<nowiki><includeonly>...</includeonly></nowiki>).  


These are documented elsewhere; see "External links."
The former is useful things such as displaying usage information about the template on the template's page; the latter is useful for things such as putting an article into a category when the template is used in the article into a [[category]], but not putting the template itself into the category.


==See also==
See [[Template:Disambig]] for examples of this markup
*[[Special:Prefixindex]] where you can select the '''Template''' namespace and see the names of all templates that currently exist in this wiki.
 
===Optional arguments===
You can include optional arguments using the '''$if:''' parser function. For example:
<nowiki> {{ $if: {{{company|}}} | Company name is {{{company}}} | No company name supplied}} </nowiki>
which displays "Company name is foo" if a company argument is present, or "No company name supplied" if it isn't.
 
For more information: http://meta.wikimedia.org/wiki/ParserFunctions
 
===Additional features===
There are additional features that are useful in templates, including predefined variables that do such things as calculate the name of the current article. These are documented elsewhere; see "External links."
 
==Currently defined templates==
To see descriptions of defined templates and examples of usage (if someone has provided it):
*See [[Help:List of COLLADA wiki templates]]
 
To see just the names of all templates that currently exist in this wiki:
#Either:
#*Use the '''Special pages''' link in the left navigation bar and click '''Prefix index'''.
#*Go directly to the special "article" [[Special:Prefixindex]].
#Select the '''Template''' namespace and click '''Go'''.


==External links==
==External links==
*[http://meta.wikimedia.org/wiki/Help:Template Wikimedia Help:Template article]
*[http://meta.wikimedia.org/wiki/Help:Template Wikimedia Help:Template article]
*[http://en.wikipedia.org/wiki/Wikipedia:Template_namespace Wikipedia Template namespace article]
*[http://en.wikipedia.org/wiki/Wikipedia:Template_namespace Wikipedia Template namespace article]
*[http://meta.wikimedia.org/wiki/ParserFunctions Parser functions (conditional content in templates)]


[[Category:Help]]
[[Category:Help|Templates]][[Category:Templates]]

Latest revision as of 00:18, 5 March 2009

Help
Wiki

About (overview)
Search
FAQ
Help

Navigation

Portals
Categories
Searching

Editing

Basic editing
Article names
Adding article
Formatting
Linking
Tables
Redirects
Deleting
Copying
Images

Policies and guidelines

Standard article layout
Review edits, spam
Bugs

COLLADA

FAQ
Tutorials

This wiki software allows us to define templates, which are the same concept as macros in some languages.

Overview

A template can define standard text that you'd like to appear in more than one place. For example, you could define a template named needswork that, when inserted into a page, displays text like this:

This page needs more work to make it look good.

Furthermore, templates can have arguments (parameters) that allow you to specify repetitive data in a standard and more easily understandable way. For example, you could define a template named plug-in that provides space for someone to type the basic information about a COLLADA plug-in and then displays the info in a nice format as defined within the template, rather than making the editor do all the work over and over.

Template usage

When editing an article, you include templates using double braces around the template's name, like this:

 {{needswork}}

or like this, if the template allows named arguments:

  {{plug-in | name = My Plug In | web = http://www.mycompany.com | version = 1.4}}

Template definition

To create a template, just create an article titled "Template:nameofyourtemplate"; for example, Template:needswork or Template:plug-in. Whatever you put into that article then appears whenever you insert the template (as shown in "Template usage") into another article.

For example, perhaps you want the plug-in template shown above to display text like this:



In this case, the template definition (Template:plug-in) looks similar to this:

*'''Plug-in name:''' {{{name}}}
*'''Web site:''' {{{web}}}
*'''Current released version:''' {{{version}}}

Advanced features

You can use special markup for:

  • Things that appear only in the template definition page but not where the template occurs (<noinclude>...</noinclude>).
  • Vice-versa (<includeonly>...</includeonly>).

The former is useful things such as displaying usage information about the template on the template's page; the latter is useful for things such as putting an article into a category when the template is used in the article into a category, but not putting the template itself into the category.

See Template:Disambig for examples of this markup

Optional arguments

You can include optional arguments using the $if: parser function. For example:

 {{ $if: {{{company|}}} | Company name is {{{company}}} | No company name supplied}} 

which displays "Company name is foo" if a company argument is present, or "No company name supplied" if it isn't.

For more information: http://meta.wikimedia.org/wiki/ParserFunctions

Additional features

There are additional features that are useful in templates, including predefined variables that do such things as calculate the name of the current article. These are documented elsewhere; see "External links."

Currently defined templates

To see descriptions of defined templates and examples of usage (if someone has provided it):

To see just the names of all templates that currently exist in this wiki:

  1. Either:
    • Use the Special pages link in the left navigation bar and click Prefix index.
    • Go directly to the special "article" Special:Prefixindex.
  2. Select the Template namespace and click Go.

External links