Help Wikitravel grow by contributing to an article! Learn how.

Difference between revisions of "Wikitravel:Article templates"

From Wikitravel
Jump to: navigation, search
m (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?: cap again)
m (Is "Get out" the opposite of "Get in"?)
 
(15 intermediate revisions by 13 users not shown)
Line 1: Line 1:
 +
{{confused|[[Wikitravel:Using Mediawiki templates|Mediawiki templates]]}}
 
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.
 
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]].
 
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:Country article template|Country article template]] ([[Wikitravel:quick country article template|quick version]]) - ''<nowiki>{{subst:country}}</nowiki>'' - for [[Wikitravel:geographical hierarchy#Countries|countries]]
Line 27: Line 31:
 
* 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 '''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)|New York]], 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.
+
* 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 [http://meta.wikimedia.org/wiki/Help:Template MediaWiki templates]. See [[Wikitravel:using Mediawiki templates]].
 
Note that these templates are not [http://meta.wikimedia.org/wiki/Help:Template MediaWiki templates]. See [[Wikitravel:using Mediawiki templates]].
Line 42: Line 46:
 
* Get in
 
* Get in
 
* Get around
 
* Get around
* See
+
* See (or See and Do)
 
* Eat
 
* Eat
 
* Sleep
 
* Sleep
Line 102: Line 106:
 
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.
 
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? ===
+
=== 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.  
 
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.  
Line 117: Line 121:
 
* It was was being abused by spammers and others who didn't read the [[Wikitravel:External links|External links policy]].
 
* 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.
 
* It meant that relevant links to another website got separated from other information in the article.
 +
 +
=== Is "Get out" the opposite of "Get in"? ===
 +
No.
 +
 +
We realise that this section title confuses many and there is a consensus to change it. However, it has not yet been agreed by IBadmins whether we should change it to ''Go next'' or when and how the change should happen.
 +
 +
In the section "Get out", we want you to write suggestions about where to '''go next'''; either as the next stop on your travels or where to go next just for a day trip - whether those places already have their own Wikitravel article or not.
 +
 +
''It is'' not ''intended to be a section about how to find the best transport out of town''!
  
 
==See also==
 
==See also==
Line 123: Line 136:
  
 
* [[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)
 
* [[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
  
  
 +
{{WikitravelDoc|help}}
  
  

Latest revision as of 00:04, 6 November 2012

Contents

Not to be confused with Mediawiki templates.

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. {{subst:smallcity}} 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.


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 region, copy-and-paste the Wiki markup from the 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 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[edit]

Why does every city article have to look (about) the same?[edit]

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 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?[edit]

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?[edit]

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?[edit]

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?[edit]

First, make sure it really doesn't fit in with the templates. 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 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?[edit]

First of all, make sure that your contribution is really something we want to have on Wikitravel. Check our goals and non-goals as well as 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?[edit]

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?[edit]

Firstly, make sure that the island merits an article—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 country article template. If the island contains several cities/towns that each merit an individual article (like Maui), make it a region article. If the island is small, and only has one city, or a handful of tiny settlements, don't subdivide it, use a 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?[edit]

See the external links policy for details of how external links should be used.

To avoid 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 External links policy.
  • It meant that relevant links to another website got separated from other information in the article.

Is "Get out" the opposite of "Get in"?[edit]

No.

We realise that this section title confuses many and there is a consensus to change it. However, it has not yet been agreed by IBadmins whether we should change it to Go next or when and how the change should happen.

In the section "Get out", we want you to write suggestions about where to go next; either as the next stop on your travels or where to go next just for a day trip - whether those places already have their own Wikitravel article or not.

It is not intended to be a section about how to find the best transport out of town!

See also[edit]

Variants

Actions

Destination Docents

In other languages