Wikivoyage:Listing-tags: verschil tussen versies

Verwijderde inhoud Toegevoegde inhoud
Abeona (overleg | bijdragen)
FredTC (overleg | bijdragen)
Eerste slag om van tag-beschrijvingen sjabloon-beschrijvingen te maken. WORDT VERVOLGD.
Regel 1:
{{pagebanner}}
Enige tijd na de start van Wikitravel werden de listing-tags geïntroduceerd om tot een uniforme wijze van lijsten van objecten (hotels, restaurants, bezienswaardigheden, etc.) te komen. De tags met ondersteunende programmatuur zijn ongewijzigd uit de Engelse versie van Wikitravel overgenomen, wat nog merkbaar is aan de namen van de tags en die van de invulgegevens. Wikivoyage heeft deze tags overgenomen, maar heeft deze inmiddels vervangen door sjablonen. De wijze waarop deze tagssjablonen dienen te worden gebruikt, wordt hier nader toegelicht.
 
==Mogelijke tagssjablonen==
{| class="wikitable"
|-
! TagSjabloon !! Formaat !! Toelichting
|-
| '''see''' || <nowiki><{{see | name="" | alt="" | address="" | directions="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | hours="" | price=""></see> | content=}}</nowiki> || Voor bezienswaardigheden die onder "Bekijken" staan
|-
| '''do''' || <nowiki><{{do | name="" | alt="" | address="" | directions="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | hours="" | price=""></do> | content=}}</nowiki> || Voor vermeldingen die onder "Doen" staan
|-
| '''buy''' || <nowiki><{{buy | name="" | alt="" | address="" | directions="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | hours="" | price=""></buy> | content=}}</nowiki>|| Voor vermeldingen die onder "Kopen" staan
|-
| '''eat''' || <nowiki><{{eat | name="" | alt="" | address="" | directions="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | hours="" | price=""></eat> | content=}}</nowiki> || Voor restaurants die onder "Eten" staan
|-
| '''drink''' || <nowiki><{{drink | name="" | alt="" | address="" | directions="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | hours="" | price=""></drink> | content=}}</nowiki> || Voor bars, café's, disco's, etc. die onder "Uitgaan" staan
|-
| '''sleep''' || <nowiki><{{sleep | name="" | alt="" | address="" | directions="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | checkin="" | checkout="" | price=""></sleep> | content=}}</nowiki> || Voor hotels, guesthouses, campings, etc. die onder "Overnachten" staan
|-
| '''listing''' || <nowiki><{{listing | name="" | alt="" | directions="" | address="" | lat="" | long="" scale=""| phone="" | tollfree="" | email="" | fax="" | url="" | hours="" | price=""></listing> | content=}}</nowiki> || Voor vermeldingen die niet onder de hiervoor vermelde hoofdstukken staan
|}
 
==De invulling==
Alle tagssjablonen, op dehet sleep-tagsjabloon na, hebben de zelfde (mogelijke) invulgegevens. Bij ''sleep'' is '''hours''' vervangen door '''checkin''' en '''checkout''', wat voor accommodaties meer van toepassing is.
Gegevens van andere aard, zoals beschrijvende informatie, kan worden geplaatst tussenachter '''<big>pricecontent=""></big>''' en '''<big></</big>'''. Als ieder invulgegeven wordt ingevuld met de naam van dat invulgegeven, dan ziet dat er als volgt uit:
* <nowiki><{{listing | name="name" | alt="alt" | address="address" | directions="directions" | lat="" | long="" scale=""| phone="phone"+31 123 | tollfree="tollfree"+31 456 | email="email"@website.com | fax="fax"+31 789 | url="url"http://www.website.com | hours="hours" | price="price"> | content=Beschrijvende informatie.</listing>}}</nowiki>
Met als resultaat in het artikel:
* <{{listing | name="name" | alt="alt" | address="address" | directions="directions" | lat="" | long="" scale=""| phone="phone"+31 123 | tollfree="tollfree"+31 456 | email="email"@website.com | fax="fax"+31 789 | url="url"http://www.website.com | hours="hours" | price="price"> | content=Beschrijvende informatie.</listing>}}
En voor dehet afwijkende sleep-tagsjabloon is dit respectievelijk:
* <nowiki><{{sleep | name="name" | alt="alt" | address="address" | directions="directions" | lat="" | long="" scale=""| phone="phone"+31 123 | tollfree="tollfree"+31 456 | email="email"@website.com | fax="fax"+31 789 | url="url"http://www.website.com | checkin="checkin" | checkout="checkout" | price="price"> | content=Beschrijvende informatie.</sleep>}}</nowiki>
* <{{sleep | name="name" | alt="alt" | address="address" | directions="directions" | lat="" | long="" scale=""| phone="phone"+31 123 | tollfree="tollfree"+31 456 | email="email"@website.com | fax="fax"+31 789 | url="url"http://www.website.com | checkin="checkin" | checkout="checkout" | price="price"> | content=Beschrijvende informatie.</sleep>}}
NB Voor phone=, tollfree=, email=, fax= en url= zijn niet de namen van de invulgegevens ingevuld, maar waarden die door controlerende software wordt herkend als (mogelijk) correct gegeven.
In de resultaten staat het pictogrammetje [[file:P_geography_3_b.png|16px]] na '''name (''alt'')'''. Hierop kan geklikt worden, waarna de webpagina wordt getoond die met '''url=""''' is gespecificeerd.<br /><br />
 
In hiervoor gegeven voorbeelden zijn enkele invulgegevens ongebruikt gebleven. Het gaat om '''lat=""''', '''long=""''' en '''scalelong=""'''. Dit betreft toevoegingen die in maart 2013 (lat/long) en januari 2014 (scale) zijn gemaakt. Met deze toevoeging kan de plaats op de kaart zichtbaar worden gemaakt. Kijk wat er gebeurt als ook deze invulgegevens worden toegevoegd:
* <nowiki><listing name="name" alt="alt" address="address" directions="directions" lat="52.373148" long="4.891785" scale="5000" phone="phone" email="email" fax="fax" url="url" hours="hours" price="price">Beschrijvende informatie.</listing></nowiki>
* <nowiki>{{listing | name="name" | alt="alt" | address="address" | directions="directions" | lat="52.373148" | long="4.891785" scale="5000"| phone="phone"+31 123 | tollfree="tollfree"+31 456 | email="email"@website.com | fax="fax"+31 789 | url="url"http://www.website.com | hours="hours" | price="price"> | content=Beschrijvende informatie.}}</listingnowiki>
* <nowiki><{{listing | name="name" | alt="alt" | address="address" | directions="directions" | lat="52.373148" | long="4.891785" scale="5000"| phone="phone"+31 123 | tollfree=+31 456 | email="email"@website.com | fax="fax"+31 789 | url="url"http://www.website.com | hours="hours" | price="price"> | content=Beschrijvende informatie.</listing></nowiki>}}
In het resultaat is maar weinig verandering te zien, alleen hetis pictogrammetjeer [[file:14X14een Géolocalisationgekleurd 2PR.gif]]rechthoekje ismet een getal aan het begin toegevoegd. Hierop kan geklikt worden, waarna een pagina met een klein kaartje wordt getoond, met een marker in het middelpunt. De marker staat op de coördinaten die met lat="" en long="" werden aangegeven.
 
==Het formaat van de individuele invulgegevens==
Regel 86 ⟶ 88:
* long="15.42638888888889"
* long="-15.42638888888889"
 
===scale===
Hier dient de "n" te worden opgegeven van "de kaart is op schaal 1:n". De kaart is in dit geval een deel van het scherm Kaartbronnen, dat wordt verkregen door op het pictogrammetje [[file:14X14 Géolocalisation 2PR.gif]] te klikken. Als 5000 wordt opgegeven is de schaal dus 1:5000. Dit is een begin 2014 toegevoegde functionaliteit. Vóór deze toevoeging was het een vaste schaal 1:100000, en moest er een aantal malen worden ingezoomd voordat je een duidelijke indruk kreeg van de precieze kaartpositie. Met de waarde 5000 is een redelijk deel van de omgeving van het object in beeld, en zijn ook straatnamen zichtbaar. Eenmaal inzoomen en je ziet ook namen van winkels, café's, etc. Eenmaal uitzoomen en je krijgt een nog wat ruimere omgeving met ook nog veel straatnamen. Voorbeeld:
*scale="5000"
 
===phone===
Regel 107 ⟶ 105:
Maar fout is dus:
* email="naam@website.com (wordt alleen om 09:00 Nederlandse tijd bekeken op nieuwe mailtjes)"
* <{{sleep | name="Voorbeeld" alt="" address="" directions="" phone="" email="naam@website.com (wordt alleen om 09:00 Nederlandse tijd bekeken op nieuwe mailtjes)" fax="" url="" checkin="" checkout="" price="">(bij aanklikken gat het wel goed)</sleep>
* email="naam1@website.com (eigenaar) of naam2@website.com (receptie)"
* <{{sleep | name="Voorbeeld" alt="" address="" directions="" phone="" email="naam1@website.com (eigenaar) of naam2@website.com (receptie)" fax="" url="" checkin="" checkout="" price="">(bij aanklikken gaat de mail naar het eerste adres)</sleep>
 
===fax===
Regel 156 ⟶ 154:
 
==Enkele opmerkingen betreffende de lay-out==
Als een tagsjabloon veel tekst bevat, dan wordt dankzij de "'''*'''" aan het begin van de regel alle tekst op vervolgregels automatisch ingesprongen.
* <nowiki><{{listing | name="Een lange lange lange lange lange naam" alt="alt" address="Een lang lang lang lang lang adres" directions="Lange lange lange lange lange lange directions" lat="" long="" scale="" phone="veel veel veel veel veel veel veel veel telefoonnummers" email="langlanglanglanglanglanglanglangemail@adresadresadresadresadresadresadres.com" fax="veel veel veel veel veel veel veel veel faxnummers" url="url" hours="hours" price="price">Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. </listing></nowiki>
* <{{listing | name="Een lange lange lange lange lange naam" alt="alt" address="Een lang lang lang lang lang adres" directions="Lange lange lange lange lange lange directions" lat="" long="" scale="" phone="veel veel veel veel veel veel veel veel telefoonnummers" email="langlanglanglanglanglanglanglangemail@adresadresadresadresadresadresadres.com" fax="veel veel veel veel veel veel veel veel faxnummers" url="url" hours="hours" price="price">Veel beschrijvende informatie. Nieuwe regel gewenst. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie.</listing>
Maar als in de beschrijvende informatie een zin links in de kantlijn moet komen, dan veroorzaakt de enter-toets het volgende beeld:
* <{{listing | name="Een lange lange lange lange lange naam" alt="alt" address="Een lang lang lang lang lang adres" directions="Lange lange lange lange lange lange directions" lat="" long="" scale="" phone="veel veel veel veel veel veel veel veel telefoonnummers" email="langlanglanglanglanglanglanglangemail@adresadresadresadresadresadresadres.com" fax="veel veel veel veel veel veel veel veel faxnummers" url="url" hours="hours" price="price">Veel beschrijvende informatie.
Nieuwe regel gewenst. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie.</listing><br /><br />
De oplossing is het gebruik van <nowiki><br /></nowiki> op de plek waar je de enter-toets had willen gebruiken:
* <{{listing | name="Een lange lange lange lange lange naam" alt="alt" address="Een lang lang lang lang lang adres" directions="Lange lange lange lange lange lange directions" lat="" long="" scale="" phone="veel veel veel veel veel veel veel veel telefoonnummers" email="langlanglanglanglanglanglanglangemail@adresadresadresadresadresadresadres.com" fax="veel veel veel veel veel veel veel veel faxnummers" url="url" hours="hours" price="price">Veel beschrijvende informatie.<br />Nieuwe regel gewenst. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie. Veel beschrijvende informatie.</listing>
 
==Mogelijke toekomstige ontwikkelingen==
Op Wikivoyage in andere talen zijn ze al verder met vooral het gebruik maken van geografische coördinaten. Als onze Nederlandse Wikivoyage deze ontwikkelingen gaat volgen, dan zijn er enkele dingen waar we nu al rekening mee kunnen houden. Enkele mogelijke ontwikkelingen:
* Bij telefoonnummers wordt min of meer willekeurige tekst toegelaten in deze handleiding. Hierdoor kan een latere koppeling naar ''bellen met de smartphone'' mogelijk een aanpassing noodzakelijk maken.
* Als onder één kopje (Bekijken, Doen, ...) meerdere tag-types doorelkaar worden gebruikt, gaat het op een kaartje dat via sjabloon "mapframe" (op de Engelse Wikivoyage) fout met de genummerde markers. Voorbeeld: onder Bekijken staan achtereenvolgens see, see, see, do, buy, see, see; dan ontstaan de genummerde markers see1, see2, see3, do1, buy1, see1, see2.
:Dit zou kunnen gebeuren als je bij een bezienswaardigheid ook nog iets kunt doen en kopen, waarbij je kiest voor de volgende notatie:
:* See
:* See
:** Do
:** Buy
:* See
:* See
:* See
 
 
{{WikivoyageDoc|stijlhandboek}}