Rules/Templates
It's a good idea to keep Knowledge Base content uniform. We try to do that by following the article naming conventions and style guidelines as much as possible. Another thing that helps is using templates, which provide an easy way to add pre-defined content and (sometimes) formatting to articles.
Discuss these conventions on the Talk page.
"Applies to" templates
Some concepts apply to more than one application. To simplify maintenance, editors sometimes create articles that apply to two or more apps. Such articles do not have an application name in their titles, so in order to make it clear what application(s) a given article applies to, editors should put a blurb like this in the beginning of the article:
- This article applies to Firefox and Thunderbird.
You can achieve this (and also have your article partially categorized) by using a template. Due to technical limitations of WikiMedia, we actually have a few different templates, for different number of params each.
Usage: {{appliesto2|Application1|Application2|Subcategory}}
becomes
: ''This article applies to {{Firefox}} and {{Thunderbird}}.'' [[Category:Subcategory (Application1)]] [[Category:Subcategory (Application2)]]
Remember to add additional categories manually.
"upto" template
Use the upto template to specify that given category is a subcategory of another category.
For example putting {{upto|Firefox}} on a category page means that that category in a subcategory of Category:Firefox. This template should be placed at the beginning of the category page.
If a subcategory has two parent categories, then use the upto2 template, for example {{upto2|Firefox|Thunderbird}}.
"org" template
Use org template to put a page in Category:MozillaZine Knowledge Base organization. It's a shortcut and we'll also be able to put some text on all organizational pages when/if we need this.
Usage: put {{org}} at the top of the page. Don't put on talk pages.
Template for linking to an application's category
A shorthand way to link to an applications's category is to use {{Application name}}
. For example: {{Firefox}}
expands to [[:Category:Firefox|Firefox]]
and looks like this: Firefox.
Implemented templates: {{Firefox}}, {{Thunderbird}}, {{Mozilla Suite}}.
Other useful templates
Other useful templates include the following:
- stub — usage: {{stub}}
- wrongtitle — usage: {{wrongtitle|title=Good Page Name}}
- cleanup — usage: {{cleanup}}
- merge — usage: {{merge}} [[Better Article]]
- mergefrom — usage: {{mergefrom}} [[Bad Article]]
- noquestions — usage: {{noquestions}}
- appliesto — usage: {{appliesto|AppName|CatNameMinusAppNameSuffix}} e.g. {{appliesto|Firefox|Issues}}
- update — usage: {{update}}
- Request for comments — usage: {{Request for comments}}
- prettytable — usage: see In-House Style or Cookies for an example
- devmo-wip — usage: {{devmo-wip|wip=http://url.to.devmo.page}}
- Template:bug — usage: {{bug|12345}}
For a list of all templates (most of which are not used), see Special pages - All pages - Templates.
External links
- Template usage in MediaWiki
- A category tag in a template; caching problem (section from above link)