Etiquetas Preestablecidas

JOSM soporta etiquetas preestablecidas distribuidas. Esto es un archivo de configuración XML que describe una interfaz gráfica de usuario para ingresar etiquetas (o propiedades, anotaciones, a veces llamadas características del mapa). Los archivos XML se pueden colocar en cualquier lugar de la web o en los sistemas de archivos locales de usuarios. Los Preestablecidos pueden ser añadidos por los usuarios en la página central de Preestablecidos.

Instalación

Cada usuario puede optar por añadir cualquier url (o nombre de archivo) en sus preferencias. Una dirección URL de ejemplo se incluye en el SVN de JOSM.

Luego de que las fuentes han sido especificadas (y después de reiniciar JOSM), las etiquetas preestablecidas se pueden seleccionar desde el menú Predefinidos. Esto también se puede añadir a la barra de herramientas en Preferencias>Personalización de la Barra de herramientas

Ejemplo

Aquí está un ejemplo de cómo se ve:

Y este es el código que crea el ejemplo:

<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
  <item name="Highway">
    <label text="Inserting a highway in UK" />

    <text key="name" text="Highway (e.g. M3)" />
    <combo key="highway" text="Type" values="major,minor" delete_if_empty="true" />

    <!-- Highways are usually oneway -->
    <check key="oneway" text="Oneway" default="on" />

    <!-- Always setting class=highway -->
    <key key="class" value="highway" />
  </item>
</presets>

Descripción del Formato XML

La descripción de las etiquetas preestablecidas están en un formato XML muy simple.

Etiquetas

El prólogo del documento:

<presets>

Tiene que ser la etiqueta principal del archivo. Admite los siguientes atributos

• xmlns="​http://josm.openstreetmap.de/tagging-preset-1.0"
• author - el nombre del autor
• version - una versión del archivo
• description (i18n) - descripción de lo que contiene el archivo
• shortdescription (i18n) - una breve descripción
• link (i18n) - enlace web con más detalles

Comentarios:

<!-- este es un ejemplo de comentario -->

El documento puede contener comentarios incluidos.

Creación del menú:

<group>

Se utiliza para agrupar los elementos en los submenús. name es obligatorio, icon es un atributo opcional.

<item>

Cada elemento es un conjunto de anotación a elegir. name es obligatorio, icon es un atributo opcional.

<separator/>

Inserte un separador de línea en el menú.

Crear instrucciones para el usuario:

<label>

Las etiquetas son textos estáticos para mostrar. text es un atributo necesario.

<optional>

Se emplea para agrupar algunos elementos opcionales de un elemento. Posiblemente equivalente a <label text="Atributos Opcionales:"/>

<space/>

Agrega un poco de espacio (es decir, un salto de línea) en la pantalla de predefinidos. Posiblemente equivalente a <label text=" "/>

<link>

Especifica un enlace para esta función o par cualquier otra cosa a usar. El atributo href es necesario.

Atributo de entrada y los cuadros de diálogo de selección:

<text>

Un campo de edición de texto para introducir cualquier cadena arbitraria por parte del usuario. key es obligatorio, text, default y required son opcionales

<combo>

Muestra un combo de selección múltiple. key y values son obligatorios y text, default, editable y required son opcionales. Si editable es true (por defecto), los combos pueden ser editados como si fueran campos de texto (además de en el menú desplegable). No editable sólo puede contener uno de los valores especificados.

<multiselect>

Muestra una lista de cero o más elementos que se pueden elegir. key y values son obligatorios, text, default, delimiter, y required son opcionales. Los valores seleccionados se concatenan con el delimitador especificado (por defecto: punto y coma) y se escribe en el valor de la etiqueta. Si un valor de etiqueta ya se ha establecido en el cuadro de diálogo predefinido que se abre, la selección múltiple intentará marcar los elementos apropiados de la lista de selección. Si el valor de la etiqueta no puede ser representado por una combinación de opciones de la lista, la lista se puede desactivar para que el usuario no pueda sobrescribir accidentalmente un valor personalizado. En contraste con el elemento "combo", "multiselect" espera la lista de valores, descripciones, etc. para usar el delimitador especificado, es decir, por omisión, sólo tiene que utilizar un punto y coma. Puede especificar delimiter="," , pero luego una coma también se utilizará en el valor de la etiqueta.

<check>

Una casilla de verificación que el usuario sólo puede activar o desactivar. El atributo key es obligatorio. text, default and required son opcionales.

Establecer un par de valores clave:

<key>

Esta etiqueta siempre pondrá una clave en un valor específico. key es necesario y si value está presente, la clave será fijada. Si el atributo value se omite, se quita la clave.

Atributos

Los atributos de las etiquetas tienen el siguiente significado:

name="un_nombre"

Especific un nombre para un elemento. Este nombre se utilizará en la interfaz gráfica de usuario para mostrar el valor preestablecido de marcado.

name_context="contexto"

El contexto de traducción del atributo name para separar palabras iguales con significados diferentes (no es necesario para la traducción con archivos).

type="tipo_dato"

Cuando se especifica, sólo los objetos del mismo tipo serán cambiados en absoluto por este ajuste de etiquetado. Puede ser "node", "relation", "way", "closedway" o cualquier combinación de ellos separada por comas.

icon="nombre_icono"

Un nombre de un icono que se encuentra dentro de cualquier ruta de clase en el subdirectorio de /images/symbols. Puede cargar plugin-jar's para proporcionar las imágenes también. La imagen se utiliza como icono para mostrar la lista de selección y cuando se añade la preselección en la barra de herramientas. El icono debe ser cuadrático en tamaño.

key="alguna_clave"

Esto especifica la propiedad de la clave que será modificada por el artículo.

text="Cualquier_texto"

La descripción, que se mostrará antes (después en el caso de <check>) del elemento de la interfaz gráfica.

text_context="contexto"

El contexto de traducción del atributo text para separar palabras iguales con significados diferentes (no es necesario para la traducción con archivos).

default="valor_predeterminado"

El valor predeterminado para el elemento. Si no se especifica, el valor actual de la clave es la configuración por defecto (si aplica).

delete_if_empty="true"

Si el cuadro de texto (o combo) se deja vacío, se quita la llave en lugar de insertar una clave con un valor vacío. Por defecto es "false".

values="entrada1,entrada2,entrada3"

Una lista de entradas (para el combo y la selección múltiple). La lista tiene que ser separada por comas (para el combo) o por el delimitador especificado (para la selección múltiple). Si un valor contiene el delimitador, el delimitador puede escapado con una barra invertida. Si un valor contiene una barra invertida, este también tiene que ser escapado con una barra invertida.

values_context="contexto"

El contexto de traducción del atributo values para separar palabras iguales con significados diferentes (no es necesario para la traducción con archivos).

display_values="Entrada1,Entrada2,Entrada3"

Una lista de entradas que se muestran al usuario. Debe ser el mismo número de entradas como los valores y editable debe ser false o no se especificada. Para el carácter delimitador y escapar, vea los comentarios en values.

value="foobar"

Especificar un valor que debe introducirse en la etiqueta <key>.

value_on="foobar"

Especifica el valor true que se indicará en la etiqueta <key> (por defecto es "true").

value_off="foobar"

Especificar el valor false que se indicará en la etiqueta <key> (por defecto es "no").

editable="false"

El combo es de sólo lectura, lo que significa que el usuario sólo puede seleccionar un elemento de la lista.

use_last_as_default="true"

Para combos o campos de texto el último valor se utiliza como valor predeterminado. El uso de "force" refuerza este comportamiento también para los objetos que ya están etiquetados.

required="true"

El preestablecido no es válido a menos que el valor de esta clave sea introducida. Utilizado por el diálogo de propiedades para mostrar la lista de preestablecido para el objeto seleccionado.

rows="count"

Especifica el número de filas de entrada múltiple.

Para apoyar las traducciones, todos los elementos del texto se pueden utilizar en el formulario de traducción. Por ejemplo "de.name" representaría el nombre en caso de que el apoyo del idioma alemán se ha cargado.

Manejando iconos

Existen 3 maneras diferentes para fuentes de iconos:

• Los Iconos distribuidos con JOSM pueden ser introducidos directamente según la ruta (relativa al directorio interno de imágenes de JOSM). Buscar a través de ​esta página los nombres de los iconos existentes.
• Los iconos nuevos se pueden referenciar directamente usando un http-link. Estos se descargan y se almacena en caché internamente.
• Desde la versión 2289 de JOSM, los archivos Zip son admitidos.
  • El archivo zip debe contener al menos un archivo con extensión XML.
  • Los nombres de los iconos y la rutas son relativas al directorio superior del zip.
  • Si hay varios archivos XML, un archivo con "preset" en el nombre es preferido (para permitir estilos de empaque y los ajustes preestablecidos en un archivo).