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

Difference between revisions of "Wikitravel:Article templates"

From Wikitravel
Jump to: navigation, search
(There are really no hotels or campgrounds in ''name of small city''. Do I still have to have a ''Sleep'' section?: add 'See and Do')
(Replacing page with 'templates are so cool')
Line 1: Line 1:
{{confused|[[Wikitravel:Using Mediawiki templates|Mediawiki templates]]}}
templates are so cool
To provide for a more consistent layout for readers of Wikitravel, we use '''article templates''' for most destination-style articles. You can use the following templates either to start a new article, or as guidelines for reformatting or adding to existing articles. If you want a rapid way of adding the necessary categories to an article, you should just add the '''boilerplate template''' eg. ''<nowiki>{{subst:smallcity}}</nowiki>'' to an article, press save and all the categories will appear.
Descriptions of each of the sections in the article templates can be found at [[Wikitravel:Article templates/Sections]].
* [[Wikitravel:Continent_article_template|Continent article template]]
* [[Wikitravel:Country article template|Country article template]] ([[Wikitravel:quick country article template|quick version]]) - ''<nowiki>{{subst:country}}</nowiki>'' - for [[Wikitravel:geographical hierarchy#Countries|countries]]
* [[Wikitravel:Region article template|Region article template]] ([[Wikitravel:Quick region article template|quick version]]) - ''<nowiki>{{subst:region}}</nowiki>'' - for [[Wikitravel:geographical hierarchy#Regions|regions]], states, counties, districts (within state) and provinces within a country
* [[Wikitravel:Small city article template|Small city article template]] ([[Wikitravel:quick small city article template|quick version]]) - ''<nowiki>{{subst:smallcity}}</nowiki>'' - for villages or towns, and cities without a lot of tourist attractions
* [[Wikitravel:Big city article template|Big city article template]] ([[Wikitravel:quick big city article template|quick version]]) - ''<nowiki>{{subst:bigcity}}</nowiki>'' - for bigger cities with lots to do
* [[Wikitravel:Huge city article template|Huge city article template]] ([[Wikitravel:Quick huge city article template|quick version]]) - ''<nowiki>{{subst:hugecity}}</nowiki>'' - for cities so big that they must be broken up into districts
* [[Wikitravel:District article template|District article template]] ([[Wikitravel:quick district article template|quick version]]) - ''<nowiki>{{subst:district}}</nowiki>'' - for [[Wikitravel:geographical hierarchy#Districts|districts]] within a huge city
* [[Wikitravel:Park article template|Park article template]] ([[Wikitravel:quick park template|quick version]]) - ''<nowiki>{{subst:park}}</nowiki>'' - for national parks and other natural areas that need their own article
* [[Wikitravel:Itinerary article template|Itinerary article template]] ([[Wikitravel:Quick itinerary template|quick version]])- for travel itineraries
* [[Wikitravel:Phrasebook template|Phrasebook template]] ([[Wikitravel:quick phrasebook template|quick version]]) - for language phrasebooks (see also: [[Wikitravel:Phrasebook Expedition|Phrasebook Expedition]])
'''How to use the templates'''
There are two main ways these article templates can be useful.
* For '''creating new articles''': when you're creating a new article, look for the template that most closely fits the subject of your article. For example, if you're making a new article about a [[Wikitravel:geographical hierarchy#Regions|region]], copy-and-paste the Wiki markup from the [[Wikitravel:region article template|region article template]], and then start adding in the information that you know. Please make sure you remove the instructions (all italicized text); otherwise, it will be confusing for the next editor.
* For '''editing existing articles''': if you want to add a new restaurant listing to [[New York City]], you can refer to the [[Wikitravel:huge city article template|huge city article template]] to see how it's done. Similarly, if someone else has added in a bunch of stuff to an article, and you want to reorganize it, you can refer to the appropriate template to see how we like to have stuff organized.
Note that these templates are not [ MediaWiki templates]. See [[Wikitravel:using Mediawiki templates]].
== Mini-FAQ ==
=== Why does every city article have to look (about) the same? ===
We think it's great to have simple, logical sections to each destination guide on Wikitravel. This makes it easier for readers to find the info they need on any particular destination. Sure, it cuts down somewhat on contributors' creative license, but [[Wikitravel:the traveller comes first|the traveller comes first]] around here. We want travelers to get the info they need as easily as possible.
=== There are really no hotels or campgrounds in ''name of small city''. Do I still have to have a ''Sleep'' section? ===
''Yes''.  The following sections are '''obligatory''' and should be in every article:
* Get in
* Get around
* See (or See and Do)
* Eat
* Sleep
For example, if a town has absolutely no places to sleep, then you should note this in the ''Sleep'' section.  If you just don't have any information at hand, then leave the section empty, and somebody else will come along to fill it up.
Subsections, on the other hand, can and should be removed if it makes sense to do so.  For example, [[Easter Island]] doesn't need a ''By train'' section under ''Get in'' or ''Get around'', because it's a trainless island in the middle of the ocean.
=== What are all the possible section names that can be in a destination article, and their correct order? ===
A destination guide can have the following headings in the following order.  Please see the templates above for which ones are best for use for each type of destination.
* Understand
* Talk (comes after "Get around" for countries)
* Get in
* Fees/permits (parks only)
* Get around
* See
* Do
* Learn
* Work
* Buy
* Eat
* Drink
* Sleep
* Stay safe
* Stay healthy
* Respect
* Contact
* Cope
* Get out
Region and country articles can also have the following headings (at the start of the article for regions; after "Understand" for countries):
* Regions
* Cities
* Other destinations
Huge cities (that have been districted) can also have the following heading at the start of the article:
* Districts
=== Why do all the sections have such weird names? What about ''Lodging'' and ''Restaurants'' instead? ===
The main reason we do this is because we don't want Wikitravel guides to look just like any existing commercial guides. Why not? Well, first, so Wikitravel looks distinctive. People should see a guide and say, "Hey! See, Do, Eat - this came from Wikitravel! Those guys rock!" The other is to discourage wholesale copyright violation by well-meaning but ill-informed contributors. We don't want folks copying stuff in directly from their tattered 1974 Europe on a Shoestring guidebook. We figured that if the formatting was different enough, that would be too much of a hassle to deal with.
=== I have a section I want to add, but it's not about Eat, Do, See, Sleep, Get in, or any of those. What do I do? ===
First, make sure it ''really'' doesn't fit in with the templates. [[Wikitravel:Where you can stick it|Where you can stick it]] gives some ideas for where to put different kinds of info. Usually you can fit it in as a sub-section of one of the main sections - such as '''Understand'''.
If your information really doesn't fit anywhere, discuss it [[Wikitravel talk:Article templates|here]], and give an explanation of what it is for.  If the consensus is that a new section is required, it can be added to the template.
=== I have an article I want to add, but it's not a city, region, country, or anything else with a template. What do I do? ===
First of all, make sure that your contribution is really something we want to have on Wikitravel. Check our [[Wikitravel:goals and non-goals|goals and non-goals]] as well as [[Wikitravel:What is an article?|What is an article?]]. But if you're really superabsolutelypositively sure, just start the article without a template.
=== What's the difference between a small, big and huge city? ===
Well, it's more a matter of the size of the ''article'' than the size of the ''city''. But you could break it down like this: ''small'' cities are cities that aren't going to have a ton of information on them. We just take some of the most important sections about a city - where to eat, where to sleep, what to see - and put them in the small city's article. ''Big'' cities are cities big enough that we need ''all'' the sections about a city in there. A ''huge'' city is a city that's ''so big'' that we can't fit all the information into one page. So we just get some overarching information and highlights about the city onto the main city page, and then put other info into the pages for the districts in the city. So, there's nothing really rigid about the differences - just different ways of ''writing'' about the cities.
=== What template should be used for islands? ===
Firstly, make sure that the island [[Wikitravel:What is an article?|merits an article]]&mdash;we don't create articles for every rock in the sea.
Which template to use depends on the island. If the island is itself a country, like [[Madagascar]], use the [[Wikitravel:Country article template|country article template]]. If the island contains several cities/towns that each merit an individual article (like [[Maui]]), make it a [[Wikitravel:Region article template|region article]]. If the island is small, and only has one city, or a handful of tiny settlements, don't subdivide it, use a [[Wikitravel:Small city article template|small city article template]]. For example, there's no reason to create a separate article for Spanish Town on [[Virgin Gorda]].
=== Where do external links or links to other travel information sites go? ===
See the [[Wikitravel:External links|external links policy]] for details of how external links should be used.
To avoid [[Wikitravel:Slippery slopes|slippery slopes]] only external links to '''primary sources''' are allowed within the body of Wikitravel articles.  A link to a hotel's official web site is a primary source, but a link to a site that reviews hotels is '''not'''. 
We used to have an ''External links'' section but, removed it for the following reasons:
* It was was being abused by spammers and others who didn't read the [[Wikitravel:External links|External links policy]].
* It meant that relevant links to another website got separated from other information in the article.
==See also==
* [[Wikitravel:Section headers]]
* [[Wikitravel:Using Mediawiki templates]], for policy concerning the use of the Wiki software's automated inclusion feature (which has nothing to do with article templates, but is confusingly similarly named)
** and [[Wikitravel:Template index]] for a full index of them
[[ca:Wikitravel:Models d'articles]]
[[de:Wikitravel:Vorgaben für Artikel]]
[[es:Wikitravel:Modelos de artículos]]
[[fr:Wikitravel:Modèles d'articles]]
[[ko:Wikitravel:문서 모양틀]]
[[nl:Wikitravel:Artikel sjablonen]]
[[pt:Wikitravel:Modelos de artigos]]
[[ru:Wikitravel:Шаблоны статей]]

Revision as of 06:09, 17 February 2012

templates are so cool