Template:Category other/doc

From Guild of Archivists
< Template:Category other
Revision as of 19:25, 28 January 2016 by Alahmnat (talk | contribs) (1 revision imported)

This is the {{category other}} meta-template.

This template helps other templates detect if they are on a "Category:" page or some "other" type of page.

Usage

This template usually takes two parameters, like this:

{{category other | Category page text | Other pages text }}

If the template is on a "Category:" page, it will return this:

Category page text

If the template is on any other page, it will return this:

Other pages text

A typical usage case could be to make it so that a template only adds a category when on category pages. Thus not adding other pages that just show the template. Like this:

{{category other | [[Category:Some category maintenance category]] }}

Or to warn that a template should not be used on other pages:

{{category other | | This template should only be used on category pages. }}

Note that in the first case above the "other" parameter was not used, and in the second example the "category" parameter was left empty.

Demospace

For testing and demonstration purposes this template can take a parameter named demospace.

  • If it has the value category it returns the category page text.
  • It if has the value other or any other value such as the name of some other namespace it returns the other pages text.
  • If the parameter is empty or undefined, the actual page type determines the result.

Like this:

{{category other 
| Category page text 
| Other pages text 
| demospace = category
}}

No matter on what kind of page the code above is used it will return this:

Category page text

You can make it so your template also understands the demospace parameter. That means you can demonstrate the different appearances of your template in the documentation for your template. Then do like this:

{{category other 
| Category page text 
| Other pages text 
| demospace = {{{demospace|}}}
}}

Technical details

This template detects "Category talk:" pages as type other.

This template works like {{main talk other}}, for more examples and technical details see full documentation there.