Beautiful banners are coming to every article and you can help!
Check out our guidelines and learn how to create your own!

Difference between revisions of "Wikitravel:Listings"

From Wikitravel
Jump to: navigation, search
(Listing)
(sorry wrong place for edits; this is a policy page)
Line 2: Line 2:
 
Wikitravel uses standardized formats to list attractions, activities, shops, restaurants, bars and hotels under the '''See''', '''Do''', '''Buy''', '''Eat''', '''Drink''' and '''Sleep''' sections respectively. This page describes those listings.
 
Wikitravel uses standardized formats to list attractions, activities, shops, restaurants, bars and hotels under the '''See''', '''Do''', '''Buy''', '''Eat''', '''Drink''' and '''Sleep''' sections respectively. This page describes those listings.
  
Isla Canas is a small island on the Azuero peninsula on the Pacific side of Panama
+
==Listing order==
 +
{{Shortcut|[[Alphabet]]<br />[[wt:abc]]}}
 +
'''Alphabetical order''' should be the norm within each section. If another standard is used, it should be clearly stated (either on the [[Wikitravel:Using talk pages|discussion page]] of the article or as a [[Html#Comments|hidden comment]] above the list itself) so any new listing can be added to the appropriate place. Leading definite or indefinite articles, such as "''The''", or "''A''", in the listing's name should be ignored for the purposes of determining the order.
  
 
==Avoid long lists==
 
==Avoid long lists==
Line 30: Line 32:
 
Listings that use these tags will create correctly formatted [http://microformats.org/wiki/hcard hcard] entries, which can be copied and viewed with software like the [https://addons.mozilla.org/firefox/4106/ Operator extension] for Firefox.
 
Listings that use these tags will create correctly formatted [http://microformats.org/wiki/hcard hcard] entries, which can be copied and viewed with software like the [https://addons.mozilla.org/firefox/4106/ Operator extension] for Firefox.
  
'''Isla canas is one of the few beaches in Panama that the public can come and view turtles nesting and is only one of two beaches in Panama that has the 'arribada' nesting phenomenon which is when thousands of turtles come to lay their eggs over a few nights.This happens usually at the beginning of each month from the July to November (the breeding season), but turtles nest here year around.'''
+
===Attributes===
 +
Each attribute is one of the following listed attributes.<br />
 +
Note that the content of the ''description'' can contain wikitext, but ''not'' the content of the attributes! No attribute is required, but some are recommended to make a listing at all useful.
 +
 
 +
* '''name''': the name of the hotel, bar, restaurant, museum, or whatever. '''''Essential'''. Without a name, the small, grey <small>{{o|silver|edit}}</small> link after the listing will not display''.
 +
* '''alt''': an alternative name, either in the local language or just an alternative. ''Optional''.
 +
* '''address''': a street address for finding the listed entry, for places where this is meaningful. ''Recommended''.
 +
* '''directions''': additional brief directions besides the street address, such as cross streets, nearby subway or bus stations. ''Optional''
 +
* '''phone''': a phone number for making reservations or getting more information. ''Recommended''.
 +
* '''tollfree''': a toll-free phone number, if available. ''Optional''.
 +
* '''email''': an email address for making reservations or getting more information. ''Optional''.
 +
* '''fax''': a fax number. ''Optional''.
 +
* '''phoneextra''': any extra information for phone calls. ''Optional''
 +
* '''url''': the URL for the official Web site for this listed entry. To display properly as a working, clickable hyperlink, either <code>http://</code> or <code>https://</code> '''must''' be included before the rest of the URL! (see [[Wikitravel:external links|external links]] for more guidelines). ''Recommended''.
 +
* '''hours''': opening [[hours]] of the attraction, when applicable. ''Recommended''.
 +
* '''checkin''': checkin [[time]], for sleep listings only. ''Optional''.
 +
* '''checkout''': checkout [[time]], for sleep listings only. ''Optional''.
 +
* '''hoursextra''': any extra hours information (seasons, exceptions). ''Optional''.
 +
* '''price''': price of a room, or price of a drink, or price of an average meal, or price of admission. ''Recommended''.
 +
* '''priceextra''': any extra price information (discounts, what it applies to). ''Optional''.
 +
* '''lat''': Decimal latitude (GPS coordinates) for map output. Not yet displayed. ''Optional''.
 +
* '''long''': Decimal longitude (GPS coordinates) for map output. Not yet displayed. ''Optional''.
 +
**Note: '''lat''' and '''long''' should have the same number of decimal places (using trailing zeroes if applicable). If one is present, so should the other be.
 +
* '''geo''': comma-separated decimal latitude and longitude (GPS coordinates) of the attraction. ''Deprecated''; use lat and long instead.
 +
* '''tags''': comma-separated list of free-text tags (see [[:Wikipedia:tag (metadata)|tag]] for details). Note: not yet shown in the output. ''Optional''.
 +
 
 +
Note that the capitalization has to be identical (that is, use "name", not "Name" or "NAME"), and that empty listings (with no description) still need to have a closing tag (like <nowiki></tag></nowiki>).
  
 
==Examples==
 
==Examples==
  
'''There is a 14km stretch of beach on the western side of the island to explore which typically has very few to no people on it. Isla canas is not know for its wave but on a good day there is nice surf'''
+
===See===
 +
{{seealso|Wikitravel:Attraction listings}}
 +
'''Type:'''
  
'''see the nesting olive ridley turtles at night, walking without a flash light on will actually help you see the turtle tracks'''
+
<nowiki>* <see name="Attraction name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="21:00-17:30" price="Rs. 50 for entrance" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the attraction.</see></nowiki>
  
'''Take a boat ride through the mangrove estuary and look for monkeys and the different species of birds that inhabit this, "worlds most endangered habitat, even more mangrove forest are lost than coral reefs and tropical rainforest combined'''
+
'''to display:'''
  
'''Go fishing. Isla is a fishing and farming village you can easily find a local who will take you fishing for a few dollars and a tank of gas'''
+
* <see name="Attraction name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="21:00-17:30" price="Rs. 50 for entrance" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the attraction.</see>
  
 
===Do===
 
===Do===
Line 60: Line 90:
  
 
===Eat===
 
===Eat===
'''MAMA JITA'S HOSTAL Y RESTAURANTE- mama Jita runs the only hostel and restaurant on the island. The meals she serves are $3 each for breakfast, lunch, and dinner.She is an excellent cook and uses local produce, fish, and poultry.'''
+
{{seealso|Wikitravel:Restaurant listings}}
  
 +
'''Type:'''
 +
 +
<nowiki>* <eat name="Restaurant name"  alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 150 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the restaurant.</eat></nowiki>
 +
 +
'''to display:'''
 +
 +
* <eat name="Restaurant name"  alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 150 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the restaurant.</eat>
 +
 +
===Drink===
 +
{{seealso|Wikitravel:Bar listings}}
 +
'''Type:'''
 +
 +
<nowiki>* <drink name="Bar name"  alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 100 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the bar.</drink></nowiki>
 +
 +
'''to display:'''
  
===DRINK===
+
* <drink name="Bar name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 100 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the bar.</drink>
'''There are 3 cantinas on the island so getting a 75 cent ice cold Panama Lager or Soberana is no problem. '''
+
  
 
===Sleep===
 
===Sleep===
Line 77: Line 121:
 
* <sleep name="Hotel name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" tollfree="0800-444-5555" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" checkin="13:00" checkout="11:00" price="Rs. 1,500 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the hotel.</sleep>
 
* <sleep name="Hotel name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" tollfree="0800-444-5555" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" checkin="13:00" checkout="11:00" price="Rs. 1,500 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the hotel.</sleep>
  
===Hostel===
+
===Listing===
'''MAMA JITA'S HOSTAL Y RESTAURANTE
+
If the listing doesn't fit into one of the above categories, you can use the "listing" tag for a generic one.
Isla Canas, province Los Santos, Panama
+
tel # 6882-9695
+
Room - $15 per night
+
Meals- $3 each
+
Call ahead to make arrangements for a boat to take you through the mangroves and to the island. She doesn't speak much english. Those with cars can park overnight at the covered car port on the mainland. Bring insect repellent, mosquito net, a camera, and a flashlight. '''
+
  
'''There is no hotels or restaurants on the island. If you want to stay you need to stay at a families house. Mama Jita has a private 3 bed room for $15 a night. Longer stays are granted usually to researchers who come to study at $150 a month.'''
 
  
'''Her hostal is part of her home and she has an outhouse and outdoor shower for personal hygiene (there is no problems with the water). There are plenty of hammocks  on the property to kick back take a nap in or read a book and relax. It's a very rustic and authentic experience and tourist who want to see and live like a local in this small farming/fishing community will be pleased.'''
+
'''Type:'''
 +
 
 +
<nowiki>* <listing name="Generic name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="10:00-14:00" price="Rs. 1,500 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the listed item.</listing></nowiki>
 +
 
 +
'''to display:'''
 +
 
 +
* <listing name="Generic name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="10:00-14:00" price="Rs. 1,500 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the listed item.</listing>
  
 
== Translation ==
 
== Translation ==

Revision as of 22:23, 13 September 2013

Wikitravel uses standardized formats to list attractions, activities, shops, restaurants, bars and hotels under the See, Do, Buy, Eat, Drink and Sleep sections respectively. This page describes those listings.

Contents

Listing order

Alphabetical order should be the norm within each section. If another standard is used, it should be clearly stated (either on the discussion page of the article or as a hidden comment above the list itself) so any new listing can be added to the appropriate place. Leading definite or indefinite articles, such as "The", or "A", in the listing's name should be ignored for the purposes of determining the order.

Avoid long lists

Wikitravel is a travel guide, not the Yellow Pages.
Huge, undifferentiated lists are only marginally useful to the traveller. A general rule of thumb is that it is time to consider breaking up long lists or pruning them when entries reach double figures.

Adding and editing listings

To add a new listing, go to the article for the city which you want to add the listing to and click on the blue [add listing] link next to the appropriate section header of See, Do, Buy, Eat, Drink or Sleep. This will pop up a box where you can easily enter the listing details.

To edit an existing listing, click on the small, grey edit text after the listing.

Wiki styled text doesn't work within our XML-formatted listing tags.

For some listings, this option is not available, and you need to edit them manually by clicking on the light blue [edit] link at the top of the section.

Overview

The following section describes how to manually enter or edit XML-formatted listing tags.

These structured tags make it easier for software to format the listings correctly. Each tag type is for a different kind of listing, according to the section it's in.

The tag format follows the angle-brackets form of HTML, XML, or other SGML applications. Each tag should have the format:

<tag attribute1="..." attribute2="..." attribute3="..." attribute4="...">Some description.</tag>

Listings that use these tags will create correctly formatted hcard entries, which can be copied and viewed with software like the Operator extension for Firefox.

Attributes

Each attribute is one of the following listed attributes.
Note that the content of the description can contain wikitext, but not the content of the attributes! No attribute is required, but some are recommended to make a listing at all useful.

  • name: the name of the hotel, bar, restaurant, museum, or whatever. Essential. Without a name, the small, grey edit link after the listing will not display.
  • alt: an alternative name, either in the local language or just an alternative. Optional.
  • address: a street address for finding the listed entry, for places where this is meaningful. Recommended.
  • directions: additional brief directions besides the street address, such as cross streets, nearby subway or bus stations. Optional
  • phone: a phone number for making reservations or getting more information. Recommended.
  • tollfree: a toll-free phone number, if available. Optional.
  • email: an email address for making reservations or getting more information. Optional.
  • fax: a fax number. Optional.
  • phoneextra: any extra information for phone calls. Optional
  • url: the URL for the official Web site for this listed entry. To display properly as a working, clickable hyperlink, either http:// or https:// must be included before the rest of the URL! (see external links for more guidelines). Recommended.
  • hours: opening hours of the attraction, when applicable. Recommended.
  • checkin: checkin time, for sleep listings only. Optional.
  • checkout: checkout time, for sleep listings only. Optional.
  • hoursextra: any extra hours information (seasons, exceptions). Optional.
  • price: price of a room, or price of a drink, or price of an average meal, or price of admission. Recommended.
  • priceextra: any extra price information (discounts, what it applies to). Optional.
  • lat: Decimal latitude (GPS coordinates) for map output. Not yet displayed. Optional.
  • long: Decimal longitude (GPS coordinates) for map output. Not yet displayed. Optional.
    • Note: lat and long should have the same number of decimal places (using trailing zeroes if applicable). If one is present, so should the other be.
  • geo: comma-separated decimal latitude and longitude (GPS coordinates) of the attraction. Deprecated; use lat and long instead.
  • tags: comma-separated list of free-text tags (see tag for details). Note: not yet shown in the output. Optional.

Note that the capitalization has to be identical (that is, use "name", not "Name" or "NAME"), and that empty listings (with no description) still need to have a closing tag (like </tag>).

Examples

See

       See also: Wikitravel:Attraction listings
Type:

* <see name="Attraction name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="21:00-17:30" price="Rs. 50 for entrance" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the attraction.</see>

to display:

  • Attraction name (local or alternative name), Address (directions), +91 27 222-1234 (, fax: +91 27 222-1235), [1]. 21:00-17:30. Stuff about the attraction. Rs. 50 for entrance. (latitude,longitude)

Do

       See also: Wikitravel:Activity listings
Type:

* <do name="Activity name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="21:00-17:30" price="Rs. 50 for entrance" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff to do.</do>

to display:

  • Activity name (local or alternative name), Address (directions), +91 27 222-1234 (, fax: +91 27 222-1235), [2]. 21:00-17:30. Stuff to do. Rs. 50. (latitude,longitude)

Buy

Type:

* <buy name="Shop name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 150 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the shop.</buy>

  • Shop name (local or alternative name), Address (directions), +91 27 222-1234 (, fax: +91-22-2222-1235), [3]. 18:00-21:00. Stuff about the shop. Rs. 150 and above. (latitude,longitude)

Eat

       See also: Wikitravel:Restaurant listings

Type:

* <eat name="Restaurant name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 150 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the restaurant.</eat>

to display:

  • Restaurant name (local or alternative name), Address (directions), +91 27 222-1234 (, fax: +91 27 222-1235), [4]. 18:00-21:00. Stuff about the restaurant. Rs. 150 and above. (latitude,longitude)

Drink

       See also: Wikitravel:Bar listings
Type:

* <drink name="Bar name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="18:00-21:00" price="Rs. 100 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the bar.</drink>

to display:

  • Bar name, Address (directions), +91 27 222-1234 (, fax: +91 27 222-1235), [5]. 18:00-21:00. Stuff about the bar. Rs. 100 and above. (latitude,longitude)

Sleep

       See also: Wikitravel:Accommodation listings

Type:

* <sleep name="Hotel name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" tollfree="0800-444-5555" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" checkin="13:00" checkout="11:00" price="Rs. 1,500 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the hotel.</sleep>

to display:

  • Hotel name (local or alternative name), Address (directions), +91 27 222-1234 (toll free: 0800-444-5555, , fax: +91 27 222-1235), [6]. checkin: 13:00; checkout: 11:00. Stuff about the hotel. Rs. 1,500 and above. (latitude,longitude)

Listing

If the listing doesn't fit into one of the above categories, you can use the "listing" tag for a generic one.


Type:

* <listing name="Generic name" alt="local or alternative name" address="Address" directions="directions" phone="+91 27 222-1234" email="fakeemail@example.com" fax="+91 27 222-1235" url="http://www.example.com" hours="10:00-14:00" price="Rs. 1,500 and above" lat="latitude" long="longitude" tags="comma,separated,tag_labels">Stuff about the listed item.</listing>

to display:

  • Generic name (local or alternative name), Address (directions), +91 27 222-1234 (, fax: +91 27 222-1235), [7]. 10:00-14:00. Stuff about the listed item. Rs. 1,500 and above. (latitude,longitude)

Translation

The strings that are used for the parts of these structured listings can be translated for different languages. These are the localization strings for each part.

The tags:

eat 
MediaWiki:listing-eat-tag
drink 
MediaWiki:listing-drink-tag
see 
MediaWiki:listing-see-tag
do 
MediaWiki:listing-do-tag
sleep 
MediaWiki:listing-sleep-tag
buy 
MediaWiki:listing-buy-tag
listing 
MediaWiki:listing-listing-tag

The attributes:

name 
MediaWiki:listing-name-attr
alt 
MediaWiki:listing-alt-attr
address 
MediaWiki:listing-address-attr
directions 
MediaWiki:listing-directions-attr
phone 
MediaWiki:listing-phone-attr
email 
MediaWiki:listing-email-attr
fax 
MediaWiki:listing-fax-attr
url 
MediaWiki:listing-url-attr
hours 
MediaWiki:listing-hours-attr
price 
MediaWiki:listing-price-attr
geo 
MediaWiki:listing-geo-attr
tags 
MediaWiki:listing-tags-attr

Sources for lat/longs

There are a few Web sites that provide useful lat/long information.


See also



Variants

Actions

Destination Docents

In other languages