Wikivoyage:Listings
Wikivoyage 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 |
Adding and editing listings [edit]
To add a new listing, go to the article for the city which you want to add the listing to and click on [edit] next to the appropriate section header: See, Do, Eat, Drink or Sleep. This will allow you to edit the section of the page to add or change listings.
The easiest way to add a listing is to select the appropriate listing type from the "Listings" section of the edit toolbar - hover your mouse over each icon, and click on the one that is appropriate. Doing so will add a blank listing template to the edit window that can then be filled out.
Alphabetical order should be used whenever there's no more appropriate logical order (e.g. price, distance, north-south, day of the week, etc.). Where a non-alphabetical order is used, it should be explained if necessary.
Overview [edit]
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:
{{listing | attribute1=... | attribute2=... | content=Some description.}}
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 [edit]
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.
- 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.
- price: price of a room, or price of a drink, or price of an average meal, or price of admission. Recommended.
- lat: Decimal latitude (GPS coordinates) for map output. Optional.
- long: Decimal longitude (GPS coordinates) for map output. 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.
- tags: comma-separated list of free-text tags (see tag for details). Note: not yet shown in the output. Optional.
Examples [edit]
See [edit]
- See also: Wikivoyage:Attraction listings
Type:
* {{see
| name=Attraction name | alt=local or alternative name | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree= | fax=+91-22-2222-1235
| hours=9am-5:30pm | price=Rs. 50 for entrance
| tags=comma,separated,tag_labels
| content=Stuff about the attraction.
}}
to display:
- Attraction name (local or alternative name), Address (directions), ☎ +91-22-2222-1234, fax: +91-22-2222-1235, e-mail: fakeemail@example.com. 9am-5:30pm. Stuff about the attraction. Rs. 50 for entrance.
Do [edit]
- See also: Wikivoyage:Activity listings
Type:
* {{do
| name=Activity name | alt=local or alternative name | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree= | fax=+91-22-2222-1235
| hours=9am-5:30pm | price=Rs. 50 for entrance
| tags=comma,separated,tag_labels
| content=Stuff to do.
}}
to display:
- Activity name (local or alternative name), Address (directions), ☎ +91-22-2222-1234, fax: +91-22-2222-1235, e-mail: fakeemail@example.com. 9am-5:30pm. Stuff to do. Rs. 50 for entrance.
Buy [edit]
Type:
* {{buy
| name=Shop name | alt=local or alternative name | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree= | fax=+91-22-2222-1235
| hours=9am-9pm | price=Rs. 150 and above
| tags=comma,separated,tag_labels
| content=Stuff about the shop.
}}
to display:
- Shop name (local or alternative name), Address (directions), ☎ +91-22-2222-1234, fax: +91-22-2222-1235, e-mail: fakeemail@example.com. 9am-9pm. Stuff about the shop. Rs. 150 and above.
Eat [edit]
- See also: Wikivoyage:Restaurant listings
Type:
* {{eat
| name=Restaurant name | alt=local or alternative name | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree= | fax=+91-22-2222-1235
| hours=6-9pm | price=Rs. 150 and above
| tags=comma,separated,tag_labels
| content=Stuff about the restaurant.
}}
to display:
- Restaurant name (local or alternative name), Address (directions), ☎ +91-22-2222-1234, fax: +91-22-2222-1235, e-mail: fakeemail@example.com. 6-9pm. Stuff about the restaurant. Rs. 150 and above.
Drink [edit]
- See also: Wikivoyage:Bar listings
Type:
* {{drink
| name=Bar name | alt=local or alternative name | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree= | fax=+91-22-2222-1235
| hours=6-9pm | price=Rs. 150 and above
| tags=comma,separated,tag_labels
| content=Stuff about the bar.
}}
to display:
- Bar name (local or alternative name), Address (directions), ☎ +91-22-2222-1234, fax: +91-22-2222-1235, e-mail: fakeemail@example.com. 6-9pm. Stuff about the bar. Rs. 150 and above.
Sleep [edit]
- See also: Wikivoyage:Accommodation listings
Type:
* {{sleep
| name=Hotel name | alt=local or alternative name | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree=+1-800-444-5555 | fax=+91-22-2222-1235
| price=Rs. 1,500 and above
| checkin=noon | checkout=11am
| tags=comma,separated,tag_labels
| content=Stuff about the hotel.
}}
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, e-mail: fakeemail@example.com. Check-in: noon, check-out: 11am. Stuff about the hotel. Rs. 1,500 and above.
Listing [edit]
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 | url=http://www.example.com | email=fakeemail@example.com
| address=Address | lat=latitude | long=longitude | directions=directions
| phone=+91-22-2222-1234 | tollfree=+1-800-444-5555 | fax=+91-22-2222-1235
| hours=10am-2pm | price=Rs. 1,500 and above
| tags=comma,separated,tag_labels
| content=Stuff about the listed item.
}}
to display:
- Generic name (local or alternative name), Address (directions), ☎ +91-22-2222-1234, toll-free: +1-800-444-5555, fax: +91-22-2222-1235, e-mail: fakeemail@example.com. 10am-2pm. Stuff about the listed item. Rs. 1,500 and above.
Translation [edit]
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
- 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 [edit]
There are a few Web sites that provide useful lat/long information.
- Wikipedia gives co-ordinates for most articles about places
- 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
- http://nominatim.openstreetmap.org/ - OSM reverse geocoding http://wiki.openstreetmap.org/wiki/Nominatim
Avoid long lists [edit]
- See also: Wikivoyage:Avoid long lists
Wikivoyage 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 them up or pruning them when entries reach double figures.
Tools [edit]
- Listing parser to convert unformatted listings - made by User:Ml31415
