Sjabloon:Listing
This documentation is transcluded from Sjabloon:Listing/doc. (edit | history)
Note to editors: Please don't categorize this template by editing it directly. Instead, place the category in its documentation page, in its "includeonly" section.
Note to editors: Please don't categorize this template by editing it directly. Instead, place the category in its documentation page, in its "includeonly" section.
Documentation
[bewerken]This template is used for implementing generic business listings. There are a few attraction-specific type template which should be used instead, if applicable:
Als het gewenste niet in een van deze sjablonen past, kies je deze:
* {{Listing
| name= | url= | email=
| address= | lat= | long= | directions=
| phone= | tollfree= | fax=
| hours= | price= | image=
| wikidata=
| content=
| lastedit=
}}
:Bij ''lastedit='' vul je "'''{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}'''" in.
== Usage ==
<syntaxhighlight lang="wikitext">
* {{Listing
| type=TYPE OF LISTING (see, do, buy, eat, drink, sleep)
| name=NAME OF LISTING (normally required)
| alt=ALTERNATE NAME (possibly name in a local language)
| wikidata=WIKIDATA QID IDENTIFIER OF THE LISTING
| wikipedia=WIKIPEDIA ARTICLE NAME OF THE LISTING
| url=FULL URL OF LISTING'S WEBSITE (including '''''http[s]://''''' at the start)
| email=EMAIL ADDRESS OF LISTING
| address=PHYSICAL ADDRESS OF LISTING
| lat=LATITUDINAL POSITION OF THE LISTING (positive in the northern hemisphere)
| long=LONGITUDINAL POSITION OF THE LISTING (positive in the eastern hemisphere)
| image=NAME OF IMAGE (for thumbnail displayed when the map marker is clicked – "Image:" or "File:" prefix omitted)
| directions=SHORT DESCRIPTION OF HOW TO GET TO LISTING
| phone=PHONE NUMBER (in international format: +countrycode areacode number)
| tollfree=TOLL-FREE OR FREEPHONE NUMBER (in international format, unless unreachable from abroad)
| fax=FAX NUMBER (in international format)
| hours=OPERATING HOURS OF LISTING
| price=ADMISSION PRICE (range for attractions, one main course for restaurants or one night double occupancy for inns)
| checkin=CHECKIN TIME (sleep listings only)
| checkout=CHECKOUT TIME (sleep listings only)
| lastedit=DATE OF LAST EDIT (in ISO standard format "yyyy-mm-dd", leave this blank if importing info from the venue's website or a secondary source)
| content=BRIEF DESCRIPTION OF THE LISTING
}}
</syntaxhighlight>
There are no mandatory fields, but it strongly recommended to insert at least one (possibly the name) and preferably more as a <nowiki>{{listing}}</nowiki> with no information is useless to the voyager.
Some caveats:
* Unlike the old XML listing syntax, do '''not''' use quotation marks around your entries.
* "lat" and "long" are for [[:w:WGS84|WGS84]] coordinates' latitude and longitude, respectively (as measured and reported by most GPS receptors). Both are indicated in signed decimal form in degrees (using only an optional leading "+" or "-" sign, basic Latin digits, and "." as decimals separator), see example.
*: Do not specify any hemisphere name of abbreviation, use an optional leading sign instead: the "-" sign is required in the southern and western hemispheres; negative longitudes are used in the eastern Pacific Ocean, all the Americas, most of the northern Atlantic Ocean including Iceland, Ireland, western UK and France, the Iberian peninsula and north-western Africa).
*: Their value should be in the range from -90 to 90 inclusively for the latitude, and in the range from -180 to 180 for the longitude. The geographic poles conventionally use the arbitrary longitude 0.
*: However, world maps rendered for the most commonly used 2D projections (Mercator-like, preserving angles and shapes but not relative surfaces) will not display positions at polar latitudes (below roughly -87.5 degrees, or above roughly 87.5 degrees). Some other maps may render all positions, using projections suitable for specific regions (with their own limits).
=== Microformat ===
The template emits an [[Wikivoyage:Microformats|hCard microformat]].
===Example===
* <bdi class="vcard"><span id="Q206518"></span><span class="noprint listing-coordinates" style="display:none"><span class="geo"><abbr class="latitude">37.8013</abbr><abbr class="longitude">-122.3988</abbr></span></span><span title="Zie dit item op de kaart"><maplink description="[[File:Giant Mirror at the Exploratorium.jpeg|300px]]" group="listing" latitude="37.8013" longitude="-122.3988" show="mask,around,buy,city,do,drink,eat,go,listing,other,see,sleep,vicinity,view" zoom="17">{"type":"Feature","geometry":{"coordinates":[-122.3988,37.8013],"type":"Point"},"properties":{"marker-size":"medium","title":"Exploratorium","marker-symbol":"-number-listing","marker-color":"258825","description":"[[File:Giant Mirror at the Exploratorium.jpeg|300px]]"}}</maplink></span> [http://www.exploratorium.edu/ <span id="Exploratorium" class="fn org listing-name" style="font-weight:bold;">Exploratorium</span>]<span id="Q206518"></span>, <bdi class="adr listing-address street-address">Pier 15, 698 The Embarcadero</bdi> (<bdi class="listing-directions" style="font-style: italic;">at Green St</bdi>), <abbr title="telefoon" style="text-decoration:none">☏</abbr> <bdi class="tel listing-phone"><span class="plainlinks nourlexpansion">[tel:+1415528-4360 +1 415 528-4360]</span></bdi>. <bdi class="note listing-hours">Tu-Su 10AM-5PM; open W until 10PM, closed M</bdi>. <bdi class="note listing-content">A great kid friendly option, with lots of interactive exhibits teaching about science, with intriguing displays about the mind, natural systems, sound, sight, and much much more.</bdi> <bdi class="note listing-price">Adults: $25, Students/seniors/youth: $19, Children age 5 and under: Free</bdi>.<span class="listing-sister-icons"> [[File:Wikidata-logo.svg|16px|class=listing-sister|link=d:Q206518|Exploratorium (Q206518) op Wikidata]] [[File:Antu wikipedia.svg|16px|class=listing-sister|link=w:Exploratorium|<bdi>Exploratorium</bdi> op Wikipedia]]</span><span class="listing-metadata"> (<span class="listing-metadata-items"><bdi class="listing-lastedit">bijgewerkt jan 2015</bdi></span>)</span></bdi>
'''Source:'''
<syntaxhighlight lang="wikitext" style="white-space:pre-wrap">
* {{Listing
| name=Exploratorium | url=http://www.exploratorium.edu/ | email=
| address=Pier 15, 698 The Embarcadero | lat=37.8013 | long=-122.3988 | directions=at Green St
| phone=+1 415 528-4360 | tollfree= | fax=
| hours=Tu-Su 10AM-5PM; open W until 10PM, closed M
| price=Adults: $25, Students/seniors/youth: $19, Children age 5 and under: Free
| image=Giant Mirror at the Exploratorium.jpeg | wikipedia=Exploratorium | wikidata=Q206518
| lastedit=2015-01-15
| content=A great kid friendly option, with lots of interactive exhibits teaching about science, with intriguing displays about the mind, natural systems, sound, sight, and much much more.
}}
Notes:
- This template also allows the insertion of an "edit" link near the end of the generated text. Clicking on it will open a custom form editor to fill in the existing or missing values for supported field values.
- This "edit" link is added by a javascript extension tool (enabled on Wikivoyage), but it will not be visible in simple browsers (for old smartphones or some TV sets) that don't support Javascript, or in any browser whose Javascript has been disabled, or in any page which is not in the main namespace for articles (so it is also not visible in this template documentation page).
Associated template:
- Dependent on Template:Marker for creating a listing's header (item type, number, name, URL). The "zoom" and "group" parameters for the {{Marker}} are not currently supported or passed through by {{Listing}}.
- Lat, long, and wikidata are passed to {{marker}}. With the current behavior of {{marker}}, this means that explicit lat and long values are unnecessary if such values exist on the associated Wikidata item.
TemplateData
[bewerken]This template is used for implementing business listings.
| Parameter | Beschrijving | Type | Status | |
|---|---|---|---|---|
| Name | name | Name of the listing
| Tekenreeks | vereist |
| Alternative name | alt | Alternative name of the listing (if any)
| Tekenreeks | voorgesteld |
| URL | url | URL of listing's website, including http:// at the beginning
| URL | voorgesteld |
email | Email address of the listing | Tekenreeks | voorgesteld | |
| Address | address | Postal address of the listing
| Tekenreeks | voorgesteld |
| Latitude | lat | Latitudinal position (use decimal notation, WGS84 style). Specify NA when coordinates are not applicable, to disallow fetching the value from wikidata
| Getal | voorgesteld |
| Longitude | long | Longitudinal position (use decimal notation, WGS84 style). Specify NA when coordinates are not applicable, to disallow fetching the value from wikidata
| Getal | voorgesteld |
| Directions | directions | Short description of how to get there
| Tekenreeks | voorgesteld |
| Phone | phone | Contact phone number
| Tekenreeks | voorgesteld |
| Toll-free | tollfree | Toll-free contact number | Tekenreeks | optioneel |
| Fax | fax | Fax number
| Tekenreeks | optioneel |
| Operating hours | hours | Operating hours of listing
| Tekenreeks | voorgesteld |
| Price | price | Admission price
| Tekenreeks | voorgesteld |
| Wikipedia article | wikipedia | English Wikipedia article of the listing. Automatically acquired from Wikidata ID if present.
| Paginanaam | optioneel |
| Wikidata link | wikidata | Wikidata QID of the listing
| Getal | voorgesteld |
| Commons image | image | Wikimedia Commons image of the listing for dynamic maps. Automatically acquired from Wikidata ID if preset. If specifying manually, omit 'File:'
| Bestand | optioneel |
| Last edit | lastedit | Date of last update (use yyyy-mm-dd)
| Datum | voorgesteld |
| Description | content | Brief description of the listing
| Inhoud | voorgesteld |