YOU CAN EDIT THIS PAGE! Just click any blue "Edit" link and start writing!

Wikitravel:Using Mediawiki templates

From Wikitravel
Jump to: navigation, search

The software we use, MediaWiki, has a feature to include the contents of one article into another automatically. This is called transclusion or templating, although it has nothing to do with our article templates. (The article templates predate the idea of templating in MediaWiki.)

See Help on Templates at Wikimedia.

See also Wikitravel:Template index for a list of available templates.

Templates should be used for editorial markup and metadata. In general a template should be discussed prior to being created or modified. In some cases templates can be confusing for new users, and having large numbers of templates that perform similar functions is counter-productive. Be aware that problems such as difficulty in transferring templates to other formats (such as print or PDF), attribution issues, and maintainability may all be considerations that could make a template a non-ideal solution.

New Mediawiki Template proposals[edit]

Before a new Mediawiki Template is put into general use it needs to be discussed and accepted as good or preferably best practice. Mediawiki Templates have both advantages and disadvantages. Some situations lend themselves to Mediawiki Templates, others do not. Each application should discuss the merits and disadvantages of using a Mediawiki Template solution as opposed to other alternatives, if any.

If users wish to experiment with templates then they should explain what they are trying to do on the template talk page. That way we can all learn from the effort.

Usage documentation[edit]

Each Mediawiki Template that is intended for use by contributors should have its usage documented before it is put into widespread use. This should be done on the template talk page, as well as on a project page or help page that explains how, where and when to use the template. Those templates that are in general use should be listed here too, with links to the documentation.

Change control[edit]

Changes to any Mediawiki template, especially popular ones, should be discussed and agreed to by users before it is implemented. A substantial change to a template might confuse or distress some users editing a page if the template text also changed at the same time as their edit was made. To safeguard against this, any proposed change to any popular template should have a change control plan that describes how the out of date page/page refresh issue is being addressed.

See also[edit]

  • Template index - An index of currently implemented Mediawiki templates.
  • Article templates - Guidelines about standard sections that should be included in Wikitravel articles.