Modèle:Listing/Documentation

Ceci est la sous-page de documentation du modèle {{Listing}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.

Ce modèle utilise le module LienTéléphone, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable ou dans votre espace utilisateur. Voir le projet Scribunto si vous voulez en savoir plus.

Il existe deux possibilités de compléter un listing. Soit via l'écran de l'éditeur de listing, soit via ce modèle ou un de ses dérivés.

Éditeur de listing

Pour ouvrir l'éditeur de listing, cliquez sur « ajouter un élément de listing » à droite du titre de section dans le quel vous voulez ajouter un listing.

Titre de section [modifier][ajouter un élément de listing]

Complétez les cases, selon l'aide donnée dans la section « Ajouter ou modifier des informations » puis cliquez sur le bouton « Soumettre » lorsque vous avez terminé.

Modèle:Listing

Modèle à utiliser pour la mise en page des listes. C'est le modèle de liste directeur, reprenant l'entièreté des paramètres, dont sont dérivés toute une série d'autres modèles qui ne comportent chacun que certains des paramètres du modèle « Listing ».

Copiez-collez une des deux présentations (indentée ou compacte) dans l'article à l'endroit désiré.

Présentation indentée

* {{Listing
|nom=
|alt=
|type=
|lien nom=
|latitude=
|longitude=
|adresse=
|direction=
|image=
|url=
|wikipédia=
|wikidata=
|facebook=
|twitter=
|téléphone=
|fax=
|email=
|horaire=
|arrivée=
|départ=
|prix=
|description=
|mise à jour=
}}

Présentation compacte

Cette présentation est préférable.

* {{Listing
|nom= |alt= |type= |lien nom= |latitude= |longitude= |adresse= |direction= |image=
|url= |wikipédia= |wikidata= |facebook= |twitter=
|téléphone= |fax= |email=
|horaire= |arrivée= |départ= |prix= 
|description=
|mise à jour=
}}

Paramètres du modèle

nom

Nom du lieu (paramètre obligatoire) (Aide de Wikidata sur les labels)

alt

Nom alternatif (exemples : écriture locale, nom populaire, surnom, etc.) (Propriété P1705)

lien nom

Nom de la page à lier. Y écrire non s'il n'existe pas d'article admissible sur Wikivoyage (pas de création de lien rouge). Si vous êtes certain que le lien existe, vous pouvez laissez la valeur vide, le lien se fera automatiquement.

type

valeurs disponibles avec leur rendu tant dans l'article que sur la carte géolocalisable (Propriété P31)

aller (exemple : 1 Gare du Nord ). Voir aussi le modèle {{Aller}}

circuler (exemple : 1 Station de taxi ). Voir aussi le modèle {{Circuler}}

voir (exemple : 1 Tour de Pise (Torre pendente di Pisa) ). Voir aussi le modèle {{Voir}}

faire (exemple : 1 Ascension du Mont Blanc ). Voir aussi le modèle {{Faire}}

acheter (exemple : 1 Au Bon Chocolat ). Voir aussi le modèle {{Acheter}}

manger (exemple : 1 Restaurant Chez Moi ). Voir aussi le modèle {{Manger}}

sortir (exemple : 1 Dancing Un Tel ). Voir aussi le modèle {{Sortir}}

se loger (exemple : 1 Hôtel Hello ). Voir aussi le modèle {{Se loger}}

Cas particuliers :

dans les sections « Communiquer », « Gérer le quotidien » et « Sécurité », n'inscrire aucune valeur dans ce paramètre

exemple de rendu : 1 Bureau de poste

pour une représentation diplomatique à reprendre dans la section « Gérer le quotidien », utilisez le modèle {{Représentation diplomatique}}

exemple de rendu :

1 Belgique

dans la section « Aux environs », utilisez le modèle {{Destination}}

exemple de rendu avec un lien nom : 1 Louvain (Leuven)

exemple de rendu avec la valeur du lien nom mise sur non : 2 Forêt domaniale

dans les sections « Comprendre », « Quartiers » ou « Étapes », utilisez le modèle {{Marqueur}} sous sa forme {{Marqueur |nom= |latitude= |longitude= |image= }}

exemple de rendu : ... au nord-ouest du 50.00124.00122 centre géographique de la Belgique ...

dans les articles sur les pays ou les régions, utilisez le modèle {{Ville}} pour citer une ville et le modèle {{Destination}} pour toute autre destination

exemples de rendu :

1 Bruxelles (Brussel)

3 Chutes du Niagara (Niagara falls)

dans le corps d'un texte pour géolocaliser un lieu, utilisez le modèle {{Marqueur}}

exemple de rendu : ... Le point de départ de toutes les excursions est la 50.00154.00152 Maison du tourisme de Mon Lieu...

latitude

latitude du lieu. Valeurs acceptées: -90.0... +90.0... Pour une géolocalisation correcte, il est préférable d'utiliser une précision de décimale à cinq chiffres (Propriété P625)

longitude

longitude du lieu. Valeurs acceptées: -180.0... +180.0... Pour une géolocalisation correcte, il est préférable d'utiliser une précision de décimale à cinq chiffres (Propriété P625)

adresse

adresse du lieu. Autant que possible, il faut inscrire cette adresse selon les règles en vigueur dans le pays du lieu (voir Adresse postale) (Propriété P6375)

direction

explication pour y arriver (Propriété P2795)

image

nom complet d'une image sur Wikimédia Commons sous la forme nom image.extension. Cette image s'affichera lors d'un clic sur le point d'intérêt de la carte. (Propriété P18)

url

url complète du site web du lieu (protocoles « http:// » ou « https:// » obligatoires). En mode lecture, l’icône (lien cliquable) apparaît, en lieu et place de l'url, derrière le nom du lieu. (Propriété P856)

wikipédia

article de Wikipédia en français. Le titre (uniquement le titre) de l'article doit être repris tel qu'il est dans Wikipédia avec les éventuelles parenthèses mais sans l'insérer dans des doubles crochets. En mode lecture, l’icône (lien cliquable) apparaît, en lieu et place du titre, derrière le nom du lieu.

wikidata

éléments de Wikidata sous la forme Q1111. En mode lecture, l’icône (lien cliquable) apparaît, en lieu et place du code, derrière le nom du lieu. Pour savoir si un élément peut être relié à Wikidata, lisez la section « Que peut-on relier à Wikidata » de la page d'aide sur Wikidata.

facebook

url complète de la page Facebook. En mode lecture, l’icône (lien cliquable) apparaît, en lieu et place de l'url, derrière le nom du lieu. (Propriété P2013)

twitter

url complète de la page Twitter. En mode lecture, L’icône (lien cliquable) apparaît, en lieu et place de l'url, derrière le nom du lieu. (Propriété P2002)

téléphone

numéro de téléphone sous la forme +préfixe_national préfixe_régional numéro⁽¹⁾⁽²⁾. Plusieurs numéros de téléphone peuvent être inscrits en les séparant par une virgule (liens fonctionnels) (Propriété P1329)

⁽¹⁾ : il faut absolument faire précéder le préfixe national du signe « + » et n'insérer aucun « . » (point) pour que le lien soit fonctionnel. Pour les syntaxes autorisées, voir : Module:LienTéléphone. Pour contrôler si le lien est bien fonctionnel, dans l'onglet Gadgets de vos préférences activez Phoneinfo. Lors de la lecture de l'article, si le lien est non fonctionnel parce que la syntaxe autorisée est incorrecte, le signal FORMAT (pour mauvais formatage) ou SANSCDP (pour absence de préfixe national) apparaît derrière le numéro de téléphone, et la page courante est autocatégorisée dans une catégorie de suivi (consulter la documentation du Module:LienTéléphone qui donne des exemples de catégorisation des erreurs).

⁽²⁾ : les numéros de téléphone gratuits, abrégés ou spéciaux qui ne peuvent être appelés que depuis certains pays ou depuis les réseaux de certains opérateurs (tels que les numéros gratuits ou surtaxés de la forme 08xxnuméro ou les numéros courts de la forme 10xx, 3xxx ou 6xx en France) ne peuvent pas être inscrits dans le paramètre « téléphone » avec le format international, mais doivent être renseignés dans le paramètre « description ». Pour que le numéro indiqué forme alors un lien fonctionnel, n'insérer aucune espace entre les différents chiffres et n'utilisez pas le module « LienTéléphone » mais l'URI tel:. Il est vivement conseillé de faire suivre ces numéros dans la description d'une mention sommaire de la tarification applicable, mais déconseillé de les rendre sous forme de liens directement fonctionnels s'il s'agit de numéros d'appel d'urgence d'usage très réglementé, même s'ils sont gratuits ou fonctionnent (localement) depuis la plupart des réseaux, ou s'ils sont fortement surtaxés ou ne fonctionnent que depuis les réseaux d'opérateurs locaux spécifiques (car ces numéros pourraient avoir un usage différent et aboutir ailleurs s'ils sont appelés depuis tout autre réseau).

fax

numéro de fax sous la forme +préfixe_national préfixe_régional numéro⁽¹⁾ (lien non fonctionnel) (Propriété P1329)

email

adresse de courriel⁽³⁾ (lien fonctionnel) (Propriété P968)

⁽³⁾ : ce paramètre utilise l'URI mailto:.

horaire

jours et heures d'ouverture. Voir les modèles {{Horaire}} et {{Mois}} pour l'aide.

arrivée

chambre disponible à partir de⁽⁴⁾

départ

chambre à libérer avant⁽⁴⁾

⁽⁴⁾ : à utiliser uniquement si le paramètre « type » est complété par « Se loger ».

prix

prix ou fourchette de prix. Voir le modèle {{Prix}} pour l'aide. (Propriété P2284)

mise à jour

date sous la forme: aaaa/mm/jj. Si vous utilisez l'éditeur de listing, et non le « Modèle:Listing », cette date de mise à jour s'effectue automatiquement à la sauvegarde des modifications (bouton « Soumettre ») sans devoir l'encoder. (Propriété P813)

description

texte libre qui peut être agrémenté d’icônes laissant apparaître, en médaillon, un texte explicatif lors du passage de la souris sur cette icône.

Icônes disponibles pour le paramètre « description »

Icône	Syntaxe	Explication	Types de listing
Icône	Syntaxe	Explication	Tous	Voir	Faire	Acheter	Manger	Sortir	Se loger
	{{Handicap\|non}}	Inaccessible aux personnes à mobilité réduite.
	{{Handicap\|avec aide}}	Accessible, moyennant une aide, aux personnes à mobilité réduite.
	{{Handicap\|oui}}	Accessible, sans aide, aux personnes à mobilité réduite.
	{{Braille}}	Présence d'une aide en braille.
	{{Assistance audio}}	Présence d'une assistance auditive.
	{{Francophone}}	Le français est l'une des langues parlées de l'endroit.
	{{Défibrillateur}}	Présence d'un défibrillateur automatisé externe (DAE).
	{{Lift}}	Présence d'au moins un ascenseur.
	{{Escalator}}	Présence d'escaliers mécaniques montants et descendants.
	{{Toilettes}}	Présence de toilettes publiques hommes et femmes.
retrait	{{Bancontact\|retrait}}	Distributeur automatique de billets de banque (Belgique, France, Grand-duché de Luxembourg).
achat	{{Bancontact\|achat}}	Terminal de payement électronique (Belgique, France, Grand-duché de Luxembourg).
	{{Bancontact\|non}}	Absence d'un terminal de payement électronique (Belgique, France, Grand-duché de Luxembourg).
	{{ATM}}	Distributeur automatique de billets de banque (pays anglo-saxon).
	{{ATM\|non}}	Abscence de distributeur automatique de billets de banque (pays anglo-saxon).
	{{Crédit\|oui}}	Cartes de crédit acceptées.
	{{Crédit\|non}}	Cartes de crédit non acceptées.
	{{Wi-Fi\|oui}}	Possibilité de connexion par WI-Fi sans autre précision.
(payant)	{{Wi-Fi\|payant}}	Possibilité de connexion par WI-Fi payante.
(gratuit)	{{Wi-Fi\|gratuit}}	Possibilité de connexion par WI-Fi gratuite.
	{{Wi-Fi\|non}}	Impossibilité de connexion par WI-Fi.
	{{Panorama}}	Indique qu'un lieu offre une vue panoramique sur l’environnement.
	{{Parking relais\|}}	Parking relais.
	{{Borne électrique}}	Borne de recharge pour voiture électrique.
	{{No parking}}	Lieu sans parking prévu.
	{{PCI}}	Inscrit au patrimoine culturel immatériel de l'UNESCO.
	{{UNESCO}}	Inscrit au patrimoine mondial de l'UNESCO.
	{{RB}}	Inscrit comme réserve de biosphère de l'UNESCO.
	{{Geopark}}	Inscrit comme geopark de l'UNESCO.
	{{Patrimoine Canada}}	Lieu classé au patrimoine du Canada.
	{{English Heritage}}	Inscrit au patrimoine anglais de English Heritage.
	{{NTS}}	Inscrit au patrimoine du National Trust for Scotland.
	{{Classé MH}}	Monument classé ou inscrit au titre des monuments historiques en France.
	{{PCI-FR}}	Inscrit au patrimoine culturel immatériel français.
	{{Patrimoine Japon}}	Inscrit au patrimoine culturel du Japon.
	{{Bien d'importance suisse}}	Classé comme bien culturel d'importance nationale en Suisse.
	{{Patrimoine ukrainien}}	Classé comme bien culturel d'Ukraine.
	{{Exceptionnel Wallonie}}	Classé au patrimoine exceptionnel de Wallonie.
	{{Plus beaux villages France}}	Un des plus beaux villages de France.
	{{Plus beaux villages Italie}}	Un des plus beaux bourgs d'Italie.
	{{Plus beaux villages Japon}}	Un des plus beaux villages du Japon.
	{{Plus beaux villages Québec}}	Un des plus beaux villages du Québec.
	{{Plus beaux villages Suisse}}	Un des plus beaux villages de Suisse.
	{{Plus beaux villages Wallonie}}	Un des plus beaux villages de Wallonie.
	{{Grand site France}}	Grand site de France labellisé.
	{{Jardin remarquable}}	Jardin remarquable en France.
	{{Classe michelin\|1}}	Très bon restaurant dans sa catégorie (Guide Michelin).
	{{Classe michelin\|2}}	Excellente cuisine ; mérite le détour (Guide Michelin).
	{{Classe michelin\|3}}	Cuisine exceptionnelle ; incontournable (Guide Michelin).
	{{Classe michelin\|4}}	Assiette Michelin ; cuisine de qualité (Guide Michelin).
	{{Classe michelin\|5}}	Meilleur rapport qualité-prix ≤ 37 € (Guide Michelin).
	{{Classe michelin\|6}}	Étoile de la cuisine durable (Guide Michelin).
	{{Gault et Millau\|1}}	Note entre 11 et 12/20 (Guide Gault et Millau).
	{{Gault et Millau\|2}}	Note entre 13 et 14/20 (Guide Gault et Millau).
	{{Gault et Millau\|3}}	Note entre 15 et 16/20 (Guide Gault et Millau).
	{{Gault et Millau\|4}}	Note entre 17 et 18/20 (Guide Gault et Millau).
	{{Gault et Millau\|5}}	Note de 19/20 (Guide Gault et Millau).
	{{Gault et Millau\|6}}	pop gourmand (Guide Gault et Millau).
	{{Étoiles\|4\|4}}	Hôtel 4 étoiles⁽⁵⁾.
	{{Étoiles\|5}}	Hôtel 5 étoiles⁽⁵⁾.
	{{AAA\|4}}	Quatre diamants AAA ou CAA (États-Unis et Canada).
	{{AAA\|5}}	Cinq diamants AAA ou CAA (États-Unis et Canada).
	{{GreenKey}}	Commerce ayant reçu le label international Clé Verte/Green Key
	{{LGBT}}	Commerce ou évènement qui accueille frendly les lesbiennes, gays, bisexuels, transgenres et assimilés
	{{Fournisseur breveté-Belgique}}	Fournisseur breveté de la Cour de Belgique.
	{{Fournisseur breveté-Royaume-Uni}}	Fournisseur des familles royales du Royaume-Uni (Royal Warrant).
⁽⁵⁾ : Des modèles affichant 1, 2 ou 3 étoiles existent aussi mais leur emploi n'est pas recommandé dans le cadre du paramètre « description ».

Les étoiles hôtelières peuvent être renseignées si celles-ci sont attribuées selon des critères très stricts par des associations indépendantes comme Atout France (critères définis par une loi française) ou Hotelstars Union (association internationale regroupant 15 pays européens). Pour la Suisse, l'association Travel Weekly qui accorde la mention « De Luxe » (5 étoiles) et « Superior First Class » (4 étoiles) a les critères de sélection les plus proches des normes appliquées par Hotelstars Union et Atout France.

Hotelstars Union – Trouver la classification d'un hôtel.
Atout France – Trouver la classification d'un lieu d'hébergement.
Cinq étoiles en France – Liste des hôtels classés cinq étoiles en France (article mis à jour régulièrement).
Travel Weekly – Trouver la classification d'un hôtel en Suisse.

Les diamants AAA attribués par l'Association américaine des automobilistes sont le pendant américain des étoiles européennes en matière d'hostellerie. Ces diamants classifient non seulement les hôtels mais aussi les restaurants. Si 62 autres pays sont aussi concernés par ce type de label, il faut préférer le classement par les étoiles pour les pays européens.

Association américaine des automobilistes – Trouver un hôtel ou un restaurant 3 à 5 diamants.

Exemple

* {{Listing
|nom=Hôtel Hello
|alt=
|type=dormir
|latitude=45.13246
|longitude=2.71054
|url=http://www.hotelhello.com
|wikipédia=Bergerie
|facebook=http://www.facebook.com/#!/hellohotel
|adresse=rue du Sommeil, 1
|direction=juste à côté
|image=Lunas bergerie.JPG
|téléphone=+7 22 4098701, +7 875 409870
|fax=+7 22 4098702
|email=hotel@hello.be
|horaire={{Horaire|||6||23|}}
|arrivée={{Heure|15}}
|départ={{Heure|11}}
|prix={{Prix|50|€}}
|mise à jour=2015/03/10
|description=<tel:0800-111222> (téléphone gratuit) {{Wi-Fi|payant}} {{handicap|avec aide}} {{Lift}} C'est très joli.
}}

45.132462.710542 Hôtel Hello rue du Sommeil, 1 (juste à côté), +7 22 4098701, +7 875 409870, fax : +7 22 4098702, courriel : hotel@hello.be 6 h - 23 h. disponible à partir de 15 h, à libérer avant 11 h. 50 € (~46,88 Fr. - cours du 15/11/2024) (~74,06 $C - cours du 15/11/2024) (~52,66 $ - cours du 15/11/2024). – <tel:0800-111222> (téléphone gratuit) (payant) C'est très joli. (dernière mise à jour mars 2015)

Ancre

Il est possible de faire un lien vers un listing en particulier sous la forme :

depuis le même article : [[#Nom du lieu|Nom du lieu]]
depuis un autre article : [[Nom de l'article#Nom du lieu|Nom du lieu]]

Voir aussi

Modèles dérivés

Modèles dérivés à utiliser dans un article en fonction de la section :

Section	Type de listing	Remarque
Aller	Aller
Circuler	Circuler
Voir	Voir
Faire	Faire
Acheter	Acheter
Manger	Manger
Boire un verre / Sortir	Sortir
Se loger	Se loger
Aux environs	Destination
Autres sections	Listing	Sections « Communiquer », « Gérer le quotidien » et « Sécurité »
Représentations diplomatiques	Représentation diplomatique	sous section « Représentations diplomatiques » de la section « Gérer le quotidien »
Corps de texte	Marqueur	À placer n'importe où dans le corps d'un texte
Ville	Ville	Articles sur les pays et les régions
Autres destinations	Destination	Articles sur les pays et les régions

Voir Faire Boire un verre / Sortir	Événement	Concerne les évènements ponctuels (festival de musique, exposition temporaire, etc.). Bien que similaire, ce modèle n'utilise pas le modèle Listing.

Modèles de cartographie

Remarque

Le modèle « Listing » et l'éditeur de listing peuvent être de grands consommateurs d'adressage mémoire, surtout si le paramètre « description » est assez long. Pour garder une marge de manœuvre aisée vis à vis du nombre maximum de bytes octroyés aux différents modèles dans un même article, celui-ci ne devrait pas contenir plus de 150 éléments de listing.

Pour en savoir plus sur les statistique des limites de l'adressage mémoire d'un article afin de les contrôler : voir la section « Limites » de l'aide Modèle.