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

Difference between revisions of "Wikitravel:Using Mediawiki templates"

From Wikitravel
Jump to: navigation, search
m (Template policy)
 
(Some clarification)
Line 1: Line 1:
 
The software we use, [http://wikipedia.sourceforge.net/ MediaWiki], has a feature to include the contents of one article into another automatically. This is called ''templating'', although it has nothing to do with our [[Wikitravel:article templates|article templates]]. (The article templates predate the idea of templating in MediaWiki.)
 
The software we use, [http://wikipedia.sourceforge.net/ MediaWiki], has a feature to include the contents of one article into another automatically. This is called ''templating'', although it has nothing to do with our [[Wikitravel:article templates|article templates]]. (The article templates predate the idea of templating in MediaWiki.)
  
'''Templates should only be used for editorial metadata''', and sparingly so. For example, our [[Template:Stub]] disclaimer, or the [[Template:Disamb]]iguation identifier.
+
Templates are troublesome for a lot of reasons:
  
Templates are troublesome for a lot of reasons:
+
* '''Web-centricity''' -- it's not clear how template content should translate to print versions, if at all
 +
* '''Attribution''' -- it's not clear what attribution is needed for the creator of a template or people who worked on it
 +
* '''Other formats''' -- templates may make it difficult or impossible to convert Wiki markup to other formats (PDF, plucker, etc.)
  
* '''Attribution''' -- it's not clear what parts of a template need attribution.
+
For these reasons, '''templates should only be used for editorial metadata''', and sparingly so. For example, our [[Template:Stub]] disclaimer, or the [[Template:Disamb]]iguation identifier.
* '''Other formats''' -- template inclusion, in MediaWiki, is extremely convoluted. It may be hard to convert templates to other formats.
 

Revision as of 05:05, 15 November 2004

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

Templates are troublesome for a lot of reasons:

  • Web-centricity -- it's not clear how template content should translate to print versions, if at all
  • Attribution -- it's not clear what attribution is needed for the creator of a template or people who worked on it
  • Other formats -- templates may make it difficult or impossible to convert Wiki markup to other formats (PDF, plucker, etc.)

For these reasons, templates should only be used for editorial metadata, and sparingly so. For example, our Template:Stub disclaimer, or the Template:Disambiguation identifier.