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

Wikitravel:Listings

From Wikitravel
Revision as of 18:45, 1 September 2007 by Flip666 (Talk | contribs)

Jump to: navigation, search

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.

Note that 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.

This feature is still experimental. Feel free to use listings in new articles, but it's probably a little early to start doing wholesale conversions of old ones.


Overview

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="...">Some description.</tag>

Each attribute is one of the following listed attributes. Note that the content of the description can contain wikitext, but the content of the attributes cannot. Each attribute can only be listed twice. 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. Recommended.
  • alt: an alternative name, either in the local language or just an alternative. Optional.
  • address: a street address for finding the attraction, 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 attraction (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

Type:

* <see name="Attraction name" alt="local or alternative name" address="Address" directions="directions" phone="+91-22-2222-1234" email="fakeemail@fakehost.com" fax="+91-22-2222-1235" url="http://www.example.com" hours="9 pm -5:30 pm" 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-22-2222-1234 (, fax: +91-22-2222-1235), [1]. 9 pm -5:30 pm. Stuff about the attraction. Rs. 50 for entrance. (latitude,longitude)

Do

Type:

* <do name="Activity name" alt="local or alternative name" address="Address" directions="directions" phone="+91-22-2222-1234" email="fakeemail@example.com" fax="+91-22-2222-1235" url="http://www.example.com" hours="9 pm -5:30 pm" 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-22-2222-1234 (, fax: +91-22-2222-1235), [2]. 9 pm -5:30 pm. Stuff to do. Rs. 50. (latitude,longitude)

Buy

Type:

* <buy name="Shop name" alt="local or alternative name" address="Address" directions="directions" phone="+91-22-2222-1234" email="fakeemail@example.com" fax="+91-22-2222-1235" url="http://www.example.com" hours="6 pm -9 pm" 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-22-2222-1234 (, fax: +91-22-2222-1235), [3]. 6 pm -9 pm. Stuff about the shop. Rs. 150 and above. (latitude,longitude)

Eat

Type:

* <eat name="Restaurant name" alt="local or alternative name" address="Address" directions="directions" phone="+91-22-2222-1234" email="fakeemail@example.com" fax="+91-22-2222-1235" url="http://www.example.com" hours="6 pm -9 pm" 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-22-2222-1234 (, fax: +91-22-2222-1235), [4]. 6 pm -9 pm. Stuff about the restaurant. Rs. 150 and above. (latitude,longitude)

Drink

Type:

* <drink name="Bar name" alt="local or alternative name" address="Address" directions="directions" phone="+91-22-2222-1234" email="fakeemail@example.com" fax="+91-22-2222-1235" url="http://www.example.com" hours="6 pm -9 pm" 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-22-2222-1234 (, fax: +91-22-2222-1235), [5]. 6 pm -9 pm. Stuff about the bar. Rs. 100 and above. (latitude,longitude)

Sleep

Type:

* <sleep name="Hotel name" alt="local or alternative name" address="Address" directions="directions" phone="+91-22-2222-1234" tollfree="+1-800-444-5555" email="fakeemail@example.com" fax="+91-22-2222-1235" url="http://www.example.com" checkin="12 pm" checkout="11 am" 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-22-2222-1234 (toll free: +1-800-444-5555, , fax: +91-22-2222-1235), [6]. checkin: 12 pm; checkout: 11 am. 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-22-2222-1234" email="fakeemail@example.com" fax="+91-22-2222-1235" url="http://www.example.com" hours="10-12 pm" 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-22-2222-1234 (, fax: +91-22-2222-1235), [7]. 10-12 pm. 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