Wikitravel:Listings

Shortcut: Listing 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. Listing order Shortcut: Alphabet wt:abc 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 Shortcut: wt:2long 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 Shortcut: wt:add a listing 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 (fakeemail@example.com, fax: +91 27 222-1235), [1]. 21:00-17:30. Stuff about the attraction. Rs. 50 for entrance. (latitude,longitude) edit 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 (fakeemail@example.com, fax: +91 27 222-1235), [2]. 21:00-17:30. Stuff to do. Rs. 50. (latitude,longitude) edit 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 (fakeemail@example.com, fax: +91-22-2222-1235), [3]. 18:00-21:00. Stuff about the shop. Rs. 150 and above. (latitude,longitude) edit 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 (fakeemail@example.com, fax: +91 27 222-1235), [4]. 18:00-21:00. Stuff about the restaurant. Rs. 150 and above. (latitude,longitude) edit 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 (fakeemail@example.com, fax: +91 27 222-1235), [5]. 18:00-21:00. Stuff about the bar. Rs. 100 and above. (latitude,longitude) edit 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, fakeemail@example.com, fax: +91 27 222-1235), [6]. checkin: 13:00; checkout: 11:00. Stuff about the hotel. Rs. 1,500 and above. (latitude,longitude) edit 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 (fakeemail@example.com, fax: +91 27 222-1235), [7]. 10:00-14:00. Stuff about the listed item. Rs. 1,500 and above. (latitude,longitude) edit 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. Multimap lets you search for cities in many countries and returns lat/long info (some problems with non ASCII chars in the names) The Getty Thesaurus of Names has lat/long info for most cities in its database The Global Gazetteer from Falling Rain Genomics, Inc. is another database that gives decimal geocode values for many place names around the world. Richard Cyganiak's FOAF mapper - find co-ordinates using Google Maps. http://geonames.org/ - Quick and thorough geocoding Wikipedia gives co-ordinates for most articles about places See also Wikitravel:Microformats Wikitravel:Time and date formats Wikitravel:Phone numbers Wikitravel:Currency Wikitravel:Accommodation listings Wikitravel:Activity listings Wikitravel:Attraction listings Wikitravel:Bar listings Wikitravel:Restaurant listings Wikitravel:Shopping listings Wikitravel:Welcome, business owners Wikitravel:Don't tout