[[TranslatedPages(revision=37)]]
= 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:Presets 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.

[[Image(josm-preferences1.png)]]

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

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

[[Image(tagging_screenshot.png)]]

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 vetiqueta 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 para el nombre del atributo es igual a separar las palabras con significados diferentes (no es necesario para la traducción en archivos).
 '''type="tipo_dato"'''::
   When specified, only objects of the given type will be changed at all by this tagging preset. Can be "node", "relation", "way", "closedway" or any comma separated combination of them.
 '''icon="iconname"'''::
   A name of an icon that is within any classpath in the subdirectory of /images/symbols. You can load plugin-jar's to provide those images as well. The image will be used as icon to display in the selection list and when adding the preset to the toolbar. The icon should be quadratic in size.
 '''key="some_key"'''::
   This specifies the property key that will be modified by the item.
 '''text="Any text"'''::
   The description, that will be displayed before (after in case of <check>) the gui element.
 '''text_context="context"'''::
   Translation context for text attribute to separate equals words with different meaning (not required for in-file translations).
 '''default="default_value"'''::
   The default value for the item. If not specified, the current value of the key is chosen as default (if applicable).
 '''delete_if_empty="true"'''::
   If the text (or combo) box is left empty, the key is removed instead inserting an key with empty value. Default is "false".
 '''values="entry1,entry2,entry3"'''::
   A list of entries (for the combo box and multiselect). The list has to be separated by commas (for the combo box) or by the specified delimiter (for the multiselect). If a value contains the delimiter, the delimiter may be escaped with a backslash. If a value contains a backslash, it must also be escaped with a backslash.
 '''values_context="context"'''::
   Translation context for name attribute to separate equals words with different meaning (not required for in-file translations).
 '''display_values="Entry1,Entry2,Entry3"'''::
   A list of entries that is displayed to the user. Must be the same number of entries as values and '''readonly''' must be true or not specified. For the delimiter character and escaping, see the remarks at ''values''.
 '''value="foobar"'''::
   Specify a value to be entered in the <key> tag.
 '''value_on="foobar"'''::
   Specify the true value to be entered in the <key> tag (default is "yes").
 '''value_off="foobar"'''::
   Specify the false value to be entered in the <key> tag (default is "no").
 '''readonly="true"'''::
   The combo box is readonly, which means that the user can only select an item in the list. (Warning '''Readonly does not work''' yet as indicated in #6156 and #409)
 '''use_last_as_default="true"'''::
   For combo boxes or text fields the last value is used as default.
 '''required="true"'''::
   Preset is not valid unless value for this key is entered. Used by PropertiesDialog to show list of presets for selected object. 


To support translations, all textual elements may be used in translated form. E.g. "de.name" would represent the name in case German language support is loaded.

=== Icon handling ===
There are 3 different ways to source icons:

 * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory). Hunt through [http://josm.openstreetmap.de/svn/trunk/data/defaultpresets.xml this page] for the names of existing icons.
 * New icons can be directly referenced using a http-link. These are downloaded and cached internally.
 * Since JOSM version 2289 Zip-Files are supported.
  * The zip file must contain at least one file with extension xml.
  * Icon names and path are relative to the topmost zip directory.
  * If there are multiple XML files, a file with "preset" in the name is preferred (to allow packaging styles and presets in one archive).