[[TranslatedPages(revision=50, outdated=La sintaxis predeterminada ha cambiado y esta página tiene que ser ajustada para reflejar los cambios)]]

= 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 [wiki:Es:Presets Preestablecidos].

= Instalando preestablecidos =
Abrir la [Es:Help/Action/Preferences ventana de preferencias], hacer clic [[JOSMImage(preferences/map,20)]] en ajustes del mapa y seleccionar la tercera pestaña [Es:Help/Preferences/Map#TaggingPresets "Etiquetas preestablecidas"].

----

== Desarrollar un nuevo predefinido – Ejemplo ==

[[Image(tagging_screenshot.png,align=right)]]

{{{
#!xml
<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" />

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

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

== Desarrollar un nuevo predefinido – Añadir a la lista de predefinidos disponibles ==

Ver [[Predefinidos]].

== Desarrollar un nuevo predefinido – Descripción del formato XML ==

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

Vea la sección de comentarios en **[source:trunk/resources/data/defaultpresets.xml defaultpresets.xml]** para el **formato de descripción válido**.

----

== Desarrollar un nuevo predefinido – Descripción del formato XML (desactualizado!) ==

=== 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"'''::
   Especifica 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_de_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_de_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).
 '''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.
 '''rows="count"'''::
   Especifica el número de filas de entrada múltiple.
 '''name_template="plantilla", name_template_filter="expresión de búsqueda"'''::
   Formateador de nombre personalizado para osm primitivos que coincidan con este predefinido. Ver [[NameTemplate]] para más detalles.

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 ===
Ver [wiki:Es:Styles#Iconhandling Estilos].

== Véase también ==

* [/Presets Predefinidos]
* [wiki:Es:Help/Preferences/Map#TaggingPresets preferencias de etiquetas preestablecidas]