FR:Taginfo/Taglists
L'API Taginfo peut vous donner des listes étendues de tags. Vous décidez des balises que vous voulez dans cette liste et taginfo ajoutera les types d'éléments, la description, les images d'exemple et (en option) les compteurs d'utilisation de la base de données.
Cela peut être utilisé pour créer des tableaux de tags dans le wiki OSM en utilisant un simple template. Au lieu d'assembler et de maintenir les tables manuellement, laissez Taginfo faire le travail pour vous.
Nous sommes actuellement en train de déployer des listes de mots-clés dans ce wiki. Pour la page du projet, voir Taginfo/Taglists/Wiki project.
Intégrer des listes de tags dans ce wiki
Utilisez le template {{Taglist}} avec une liste de balises comme paramètre tags :
{{Taglist|tags=highway=motorway,trunk,primary,secondary,tertiary,maxspeed=*,oneway=yes}}
Et vous aurez une table comme celle-ci :
Notez que vous pouvez utiliser l'astérisque (*) au lieu d'une valeur pour obtenir la description/l'icône à partir d'une clé.
Définition de la langue
Vous pouvez définir la langue dans laquelle la liste doit être rédigée en utilisant le paramètre lang. La valeur par défaut est en (anglais). Donc...
{{Taglist|tags=highway=motorway,trunk,primary,secondary,tertiary,oneway=yes|lang=ru}}
...vous donne une table en russe :
Notez que pour que la localisation fonctionne, deux choses sont nécessaires :
1. Taginfo doit avoir les textes utilisés dans l'en-tête du tableau pour la langue, ils doivent être en https://github.com/joto/taginfo/blob/master/web/public/js/taglists.js. (Les mises à jour ne seront disponibles qu'après une intervention manuelle qui peut prendre quelques jours.)
2. La description de la clé/tag doit être disponible dans le wiki dans cette langue. Pour que cela fonctionne, il faut mettre à jour l'infobox sur la page de la clé/du badge. Les mises à jour seront disponibles après la prochaine mise à jour de l'infobox, généralement dans un délai d'un jour.
Ajouter le nombre d'objets au tableau
Ajoutez le paramètre with_count=true si vous voulez ajouter les comptes d'utilisation de la base de données :
{{Taglist|tags=highway=motorway,trunk,primary,secondary,tertiary,maxspeed=*|with_count=true}}
apparaîtra comme :
Ajouter un exemple de rendu au tableau
Ajoutez le paramètre with_rendering=true si vous souhaitez ajouter une image montrant comment la balise est rendue dans openstreetmap-carto, la feuille de style standard de la carte OSM :
{{Taglist|tags=shop=tea,bag|with_rendering=true}}
apparaîtra comme :
Créer une liste avec toutes les valeurs pour une clé
Vous pouvez créer une liste "all" de toutes les valeurs pour une clé donnée en donnant simplement cette clé dans la liste :
{{Taglist|tags=access}}
La liste ne contiendra pas toutes les balises, mais seulement celles documentées sur le wiki. Pour être plus précis : La page de balises doit exister et contenir la boîte d'information Template:ValueDescription. Cette utilisation n'est probablement pas celle que vous souhaitez dans la plupart des cas, car la liste peut changer et changera sans que vous le remarquiez et vous pourriez y trouver des balises étranges que vous ne vouliez pas avoir. Il est donc préférable d'écrire exactement quels tags vous voulez avoir dans cette liste.
Intégrer des listes des tags dans vos propres pages web
Inclure jQuery et taglists.js dans votre page web:
<script type="text/javascript" src=".../jquery-1.9.0.min.js"></script> <script type="text/javascript" src="https://taginfo.openstreetmap.org/js/taglists.js"></script>
Vous pouvez maintenant ajouter des listes de balises à votre page web en ajoutant un petit extrait HTML :
<div class="taglist"
data-taginfo-taglist-tags="highway=motorway,trunk,primary,secondary,tertiary">
</div>
La liste des tags peut être n'importe quoi dans le format : KEY1=VALUE1a,VALUE1b,...,KEY2=VALUE2a,VALUE2b,.... Si vous ajoutez seulement une clé, le tableau contiendra toutes les valeurs de cette clé pour laquelle nous avons une page wiki.
Vous pouvez ajouter des options en utilisant data-taginfo-taglist-options. Cela vous permet de changer la langue utilisée :
<div class="taglist"
data-taginfo-taglist-tags="natural=wood,landuse=forest"
data-taginfo-taglist-options='{"lang": "de"}'>
</div>
And you can add usage counts from the database:
<div class="taglist"
data-taginfo-taglist-tags="natural=wood,landuse=forest"
data-taginfo-taglist-options='{"with_count": true}'>
</div>
Enfin, il faut appeler la fonction convert_to_taglist pour créer les tableaux :
<script type="text/javascript">
jQuery(document).ready(function() {
taginfo_taglist.convert_to_taglist('.taglist');
});
</script>
Cela remplacera le div que vous avez entré dans votre page par le tableau.
L'élément table aura une classe de taginfo-taglist. Vous pouvez l'utiliser pour styliser la table avec le CSS.
Cette fonctionnalité utilise l'appel API tags/list taginfo. Voir https://taginfo.openstreetmap.org/taginfo/apidoc#api_4_tags_list pour plus d'informations.