Modèle:Listing/Documentation

Ceci est la page de documentation de Modèle:Listing [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

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[modifier le code]

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[modifier le code]

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[modifier le code]

* {{Listing
|nom=
|alt=
|type=
|lien nom=
|latitude=
|longitude=
|adresse=
|direction=
|image=
|url=
|wikipédia=
|wikidata=
|description=
|mise à jour=
}}

Présentation compacte[modifier le code]

* {{Listing
|nom= |alt= |type= |lien nom= |latitude= |longitude= |adresse= |direction= |image=
|url= |wikipédia= |wikidata= 
|description=
|mise à jour=
}}

Paramètres du modèle[modifier le code]

Modèle:Ambox

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 : Modèle:Marqueur ). Voir aussi le modèle {{Aller}}

circuler (exemple : Modèle:Marqueur ). Voir aussi le modèle {{Circuler}}

voir (exemple : Modèle:Marqueur ). Voir aussi le modèle {{Voir}}

faire (exemple : Modèle:Marqueur ). Voir aussi le modèle {{Faire}}

sortir (exemple : Modèle:Marqueur ). Voir aussi le modèle {{Sortir}}

Cas particuliers :

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

exemple de rendu : Modèle:Marqueur

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

exemple de rendu : Modèle:Représentation diplomatique

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

exemple de rendu avec un lien nom : Modèle:Destination

exemple de rendu avec la valeur du lien nom mise sur non : Modèle:Destination

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 Modèle:Marqueur...

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 :

Modèle:Ville

Modèle:Destination

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 Modèle:Marqueur 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é P969)
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. 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) apparait derrière le numéro de téléphone.

numéro gratuit: numéro de téléphone gratuit sous la forme 08xxnuméro (lien fonctionnel)** (Propriété P1329)

**N'insérer aucune espace entre les différents chiffres. Ce paramètre n'utilise pas le module « LienTéléphone » mais l'URI <tel:>.

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	Sortir	Se loger
Modèle:PCI	{{PCI}}	Inscrit au patrimoine culturel immatériel de l'UNESCO.
Modèle:UNESCO	{{UNESCO}}	Inscrit au patrimoine mondial de l'UNESCO.
Classé MH	{{Classé MH}}	Monument classé ou inscrit au titre des monuments historiques en France.
Modèle:Plus beaux villages France	{{Plus beaux villages France}}	Un des plus beaux villages de France.
Modèle:Plus beaux villages Italie	{{Plus beaux villages Italie}}	Un des plus beaux bourgs d'Italie.
Modèle:Plus beaux villages Japon	{{Plus beaux villages Japon}}	Un des plus beaux villages du Japon.
Modèle:Plus beaux villages Québec	{{Plus beaux villages Québec}}	Un des plus beaux villages du Québec.
Modèle:Plus beaux villages Wallonie	{{Plus beaux villages Wallonie}}	Un des plus beaux villages de Wallonie.
Modèle:Classe michelin	{{Classe michelin\|1}}	Très bon restaurant dans sa catégorie (Guide Michelin).
Modèle:Classe michelin	{{Classe michelin\|2}}	Excellente cuisine ; mérite le détour (Guide Michelin).
Modèle:Classe michelin	{{Classe michelin\|3}}	Cuisine exceptionnelle ; incontournable (Guide Michelin).
Modèle:Gault et Millau	{{Gault et Millau\|1}}	Note entre 11 et 12/20 (Guide Gault et Millau).
Modèle:Gault et Millau	{{Gault et Millau\|2}}	Note entre 13 et 14/20 (Guide Gault et Millau).
Modèle:Gault et Millau	{{Gault et Millau\|3}}	Note entre 15 et 16/20 (Guide Gault et Millau).
Modèle:Gault et Millau	{{Gault et Millau\|4}}	Note entre 17 et 18/20 (Guide Gault et Millau).
Modèle:Gault et Millau	{{Gault et Millau\|5}}	Note de 19/20 (Guide Gault et Millau).
	{{Étoiles\|4\|4}}	Hôtel 4 étoiles**.
	{{Étoiles\|5}}	Hôtel 5 étoiles**.
Modèle:AAA	{{AAA\|4}}	Quatre diamants AAA ou CAA (États-Unis et Canada).
Modèle:AAA	{{AAA\|5}}	Cinq diamants AAA ou CAA (États-Unis et Canada).						* À n'utiliser dans le paramètre « description » que si la valeur demande un complément d'information, sinon préférer les paramètres « handicap » et « wifi » pour afficher l’icône seule. ** 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.

Modèle:Marqueur Trouver la classification d'un hôtel.
Modèle:Marqueur Trouver la classification d'un lieu d'hébergement.
Modèle:Marqueur Liste des hôtels classés cinq étoiles en France (article mis à jour régulièrement).
Modèle:Marqueur 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.

Modèle:Marqueur Trouver un hôtel ou un restaurant 4 ou 5 diamants.

Exemple[modifier le code]

* {{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
|téléphone portable=+7 875 409870
|numéro gratuit=0800111222
|fax=+7 22 4098702
|email=hotel@hello.be
|mise à jour=2015/03/10
}}

Modèle:Marqueur rue du Sommeil, 1 (juste à côté) Modèle:Lift C'est très joli. (dernière mise à jour mars 2015)

Ancre[modifier le code]

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[modifier le code]

Modèles dérivés[modifier le code]

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
Voir Faire Boire un verre / Sortir	Événement	Concerne les évènements ponctuels (festival de musique, exposition temporaire, etc.). Ce modèle n'utilise pas le modèle Listing.
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

Modèles de cartographie[modifier le code]

Remarque[modifier le code]

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.