ES:Taginfo/Taglists
La API de taginfo puede proporcionar listas ampliadas de etiquetas. Usted decide qué etiquetas desea en esa lista y taginfo agregará los tipos de los elementos, su descripción, imágenes de ejemplo y (opcionalmente) recuentos de uso de la base de datos.
Esto se puede usar para crear tablas de etiquetas en la wiki de OSM mediante una plantilla simple. En lugar de ensamblar y mantener las tablas manualmente, deje que Taginfo haga el trabajo por usted.
En esta wiki se describe el uso de Taglists. Para la página del proyecto, vea el proyecto Taginfo/Taglists/Wiki project.
Incrustar listas de etiquetas en una wiki
Use la plantilla Taglist con una lista de etiquetas en el parámetro tags:
{{Taglist|tags=highway=motorway,trunk,primary,secondary,tertiary,maxspeed=*,oneway=yes}}
Y obtendrá una tabla como esta:
Observe que se puede usar el Asterisco (*) en lugar de un valor para obtener la descripción/icono para una clave.
Configurando el idioma
Puede configurar el idioma en el que debería estar la lista utilizando el parámetro language. El valor predeterminado es en (inglés). Así que...
{{Taglist|tags=highway=motorway,trunk,primary,secondary,tertiary,oneway=yes|lang=ru}}
...mostrará la tabla en Ruso:
Tenga en cuenta que para que la localización funcione, se necesitan dos cosas:
1. Taginfo necesita tener los textos utilizados en el encabezado de la tabla para el idioma, deben estar en https://github.com/joto/taginfo/blob/master/web/public/js/taglists.js. (Las actualizaciones solo estarán disponibles después de la intervención manual, lo que puede demorar algunos días).
2. La descripción de la clave/etiqueta debe estar disponible en la wiki en este idioma. Actualice el cuadro de información en la página de la clave/etiqueta para que esto funcione. Las actualizaciones estarán disponibles después de la próxima actualización de taginfo, generalmente dentro de un día.
Añadir recuento de objetos a la tabla
Añada el parámetro with_count=true si desea añadir estadísticas de uso desde la base de datos:
{{Taglist|tags=highway=motorway,trunk,primary,secondary,tertiary,maxspeed=*|with_count=true}}
se mostrará como:
Añadir ejemplos de representación a la tabla
Añada el parámetro with_rendering=true si desea añadir una imagen mostrando como se representa la etiqueta en openstreetmap-carto, la hoja de estilo estándar del mapa OSM:
{{Taglist|tags=shop=tea,bag|with_rendering=true}}
se mostrará como:
Crear una lista con "todas" las etiquetas para una clave
Puede crear una lista de "todas" las etiquetas para una clave dada simplemente incluyendo la clave en la lista:
{{Taglist|tags=access}}
se mostrará como:
La lista no contendrá todas las etiquetas, solo aquellas documentadas en la wiki. Para ser más específico: la página de etiquetas debe existir y contener el cuadro de información Template:ValueDescription. Probablemente, este uso no sea el que usted quiere en la mayoría de los casos, porque la lista puede cambiar y cambiará sin que se dé cuenta y es posible que obtenga etiquetas indeseadas. Por lo tanto, es mejor anotar exactamente qué etiquetas desea tener en esta lista.
Incrustar listas de etiquetas en sus propias páginas
Incluya jQuery y taglists.js en su página 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>
Ahora podrá añadir listas de etiquetas a su página web añadiendo un pequeño fragmento de HTML:
<div class="taglist"
data-taginfo-taglist-tags="highway=motorway,trunk,primary,secondary,tertiary">
</div>
La lista de etiquetas puede ser cualquier cosa en el formato: CLAVE1=VALOR1a,VALOR1b,...,CLAVE2=VALOR2a,VALOR2b,.... Si solo agrega una clave, la tabla contendrá todos los valores de esa clave para la que exista una página wiki.
Puede añadir opciones usando data-taginfo-taglist-options. Esto permite cambiar el idioma usado:
<div class="taglist"
data-taginfo-taglist-tags="natural=wood,landuse=forest"
data-taginfo-taglist-options='{"lang": "es"}'>
</div>
Y puede agregar estadísticas de uso de la base de datos:
<div class="taglist"
data-taginfo-taglist-tags="natural=wood,landuse=forest"
data-taginfo-taglist-options='{"with_count": true}'>
</div>
Posteriormente tendrá que llamar a la función convert_to_taglist para crear la tabla:
<script type="text/javascript">
jQuery(document).ready(function() {
taginfo_taglist.convert_to_taglist('.taglist');
});
</script>
Esto reemplazará el elemento div que ha introducido por su página con la tabla.
El elemento table tendrá la clase taginfo-taglist. Puede emplearla para asignar estilo a la tabla con CSS.
Esta funcionalidad usa la llamada tags/list a la API de taginfo. Ver https://taginfo.openstreetmap.org/taginfo/apidoc#api_4_tags_list para información adicional.