wiki:Ru:TaggingPresets

Context Navigation

Version 5 (modified by Neufoxet, 9 years ago) ( diff )
--

Если вы хотите узнать шаги по установке заготовок тегов, смотрите "Tagging Presets" tab in Preferences > Map Settings
Если вы хотите использовать заготовки тегов или необходима ссылка на заготовку, смотрите Presets
If you want to add the preset to the list of available presets see Extend JOSM#Custompresetsandpublication

Эта страница находится в процессе перевода или помечена для этой цели

Заготовки тегов

JOSM поддерживает distributed заготовки тегов. Это XML файл, описывающий графический интерфейс для ввода тегов (или свойства, аннотации, иногда называемый картой функции).

Предварительные настройки могут быть размещены в любом месте в интернете или у пользователей в локальной файловой системе. JOSM может быть настроен на использование пользовательских локальных или удаленных заготовок тегов.

Разработка новой заготовки

Заготовки тегов описываются в очень простом XML файле. Подробнее смотрите ниже.

Смотрите для примера defaultpresets.xml, охватывающий большую часть возможностей, перечисленных ниже.

Пример:

<?xml version="1.0" encoding="UTF-8"?>
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
  <item name="Oneway highway" type="way">
    <label text="Inserting a unidirectional highway" />

    <combo key="highway" text="Type" values="trunk,motorway" />
    <text key="name" text="Name (e.g. Angel Road)" />
    <text key="ref" text="Ref (e.g. A406)" />

    <!-- This is a oneway preset, so make oneway default -->
    <check key="oneway" text="Oneway" default="on" />

    <!-- Always setting asphalt surface -->
    <key key="surface" value="asphalt" />
  </item>
</presets>

Ru:TaggingPresets-preset.xml, Ru:TaggingPresets.zip

Описание XML формата

Полная схема XSD доступна по следующей ссылке (http://josm.openstreetmap.de/tagging-preset-1.0) а также the source repository.

xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"
author - имя автора заготовки
version - номер версии файла. Для указания версии вы можете использовать две встроенные переменные: [[revision]] (номер последней версии страницы wiki) и [[date]] (дата последнего редактирования).
description (i18n) - описание того, что содержит файл
shortdescription (i18n) - очень краткое описание, т.е. "name" заготовки
link (i18n) - веб-ссылка на дополнительную информацию (необязательна)
icon - информационная иконка для всей заготовки. (Это необходимо для отображения значка в таблице Presets.)
baselanguage - когда основной язык не английский, укажите его здесь (при использовании не английских текстов в заготовках, предотвращает автоматический перевод)

(i18n) означает, что значения могут быть локализованы (например de.description).

Коментарии

: Документ может содержать встроенные комментарии.

Создание группы заготовок

<group>: Используется для группировки элементов в меню. name необходимо, icon необязательный атрибут.
<item>: Every item is one annotation set to select from. name необходимо, type и preset_name_label рекомендуются, icon and name_template необязательные атрибуты.
<separator/>: Добавляет горизонтальную разделительную линию в меню.

Preset window layout

<label>: Метки для отображения статического текста. text обязательный атрибут, icon и icon_size необязательные атрибуты.
<space />: Добавляет пустую строку (перевод строки).
<optional>: Используется для группировки различных дополнительных параметров. text необязательный атрибут. Если используется без text, то это эквивалентно <space /><label text="Дополнительные атрибуты:"/><space />
<item_separator />: Добавляет горизонтальную разделительную линию между элементами.
<link>: Используется для вставки веб-ссылки. Атрибут href необходим.
<checkgroup>: Группировка флажков. Атрибут columns необходим.
<roles>: Это необходимо возле <role> и добавляет заголовок ("Availible roles role count elements") к таблице, которая образуется за счет нескольких <role>.
<role>: Чтобы указать возможные роли членов в отношениях. Атрибут key необходим, text, requisite, count, type и member_expression необязательные атрибуты.
<preset_link>: Добавляет ссылку на другую заготовку. Атрибут preset_name необходим.

Установка фиксированного значения у ключа

<key>: Этот тег позволяет присвоить какому-либо ключу определённое значение. key необходим и, если value присутствует, то ключ будет установлен. Если значение отсутствует, то ключ удаляется. match необязательный атрибут.

Атрибуты диалоговых окон ввода и выбора

<text>: Текстовое поле. Позволяет пользователю ввести любой текст. key обязателен, text, default, use_last_as_default, auto_increment, length, alternative_autocomplete_keys и match необязательны
<combo>: Отображает поле для выбора значения из списка. key м values обязательны, text, default, editable, delimiter, values_from, display_values, short_descriptions, use_last_as_default, values_searchable, length, values_no_i18n, values_sort и match необязательны.
Если editable="true" (по умолчанию), combo boxes могут быть отредактированы как если бы они были текстовыми полями (в дополнение к выпадающему списку). Недоступные для редактирования combo boxes могут содержать только одно из указанных значений или ничего.
<multiselect>: Отображает поле для выбора одного или нескольких значений (с помощью клавиши Ctrl и левой кнопки мыши) из списка. key и values обязательны, а text, default, delimiter, values_from, rows, display_values, short_descriptions, use_last_as_default, values_searchable, values_no_i18n, values_sort и match необязательные атрибуты. Перечисленные значения разделяются по умолчанию точкой с запятой (default: semicolon) and written to the tag value. Если значение тега уже установлено, когда диалоговое окно открыто, multiselect попытается отметить соответствующие пункты в списке значений как выбранные. Если значение тега не может быть представлено комбинацией значение в списке, то список будет отключен, так что пользователь не сможет случайно перезаписать произвольное значение. В отличие от элемента "combo", "multiselect" предполагает использование разделителя в списке значений, описаний и т.д. (по умолчанию точка с запятой). Можно указать разделитель delimiter="," и запятая будет использоваться в качестве разделителя перечисленных значений.
<list_entry>: Используется в <combo> и <multiselect>. Более подробную информацию смотрите short_descriptions. Атрибуты value, display_value, short_description, icon и icon_size.
<check>: Флажок, который пользователь может установить или снять (или установить отключенным/включенным). Атрибут key обязателен. text, default, match, value_on , value_off и disable_off необязательные атрибуты.

Шаблоны

<chunk>: Используется для того, чтобы определить шаблон элементов для последующего (многократного) использования. Атрибут id обязателен.
<reference>: Используется, чтобы вставить ранее определённый шаблон. Атрибут ref обязателен.

Атрибуты

Атрибуты тегов имеют следующие значения:

name="a_name"

Указывается имя для элемента. Это имя будет использоваться в графическом интерфейсе для отображения заготовки тегов.

name_context="context"

Пояснение имени атрибута для разделения одинаковых или похожих слов с различным значением (не требуется для переводов в-файле) (not required for in-file translations).

type="data_type"

When specified, only objects of the given type will work with this tagging preset. Can be "node", "way", "closedway", "multipolygon", "relation" or any comma separated combination of them. Note that "multipolygon" is not included in "relation", so if the preset should apply for multipolygons and other relation types, you need to specify both: "multipolygon,relation". Also used in the <role> tag to specify which object types are allowed for a specific relation member.

icon="iconname"

A name or link to an icon. The image will be used as icon to display in the selection list and when adding the preset to the toolbar. Icons can also be used in <item>, <label> and <list_entry>. The icon should be quadratic in size. See Styles#Iconhandling how icons can be specified.

icon_size="a number"

Максимальный размер иконки в пикселях px. Если значение не задано, то используется значение по умолчанию 16px для <list_entry /> (в <combo> и <multiselect>).

key="some_key"

Определяет свойство ключа, который будет изменен с помощью item. В случае <role> это имя роли используется в отношении.

text="Any text"

Описание, которое будет отображаться перед (после case в <check>) в графическом интерфейсе пользователя. Также используется для <label> и <optional>.

text_context="context"

Локализация пояснений ("context") для текстовых атрибутов.

default="default_value"

Значение по умолчанию для данного элемента. Если не указано, то текущее значение ключа выбирается по умолчанию (если это применимо). При использовании в <check> - установлен ли флажок или нет по умолчанию (по умолчанию "off"). При использовании в <text>, <combo> и <multiselct> по умолчанию "".

values="entry1,entry2,entry3"

Список значений для <combo> и <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_from="JAVA code"

To use instead of "values" if the list of values has to be obtained with a Java method of this form: public static String[] getValues(); The value must be: "full.package.name.ClassName#methodName".

values_no_i18n="true|false"

Отключит локализацию для значения, чтобы избежать ошибок. См. #11696. По умолчанию "false". Используется в <combo> и <multiselect>. ((Полезно, например, для часов работы или названия торговых марок..)

values_sort="false"

Значения в <combo> и <multiselect> сортируются по алфавиту на всех языках. С помощью этого атрибута вы можете отключить алфавитную сортировку, если значения должны перечисляться в заданном порядке. См #5509 и #11926. (В JOSM согласно внутренним настройкам по умолчанию для "smoothness" и "trail_visibility".) По умолчанию "true". Пользователи могут глобально отключить сортировку с the preference key taggingpreset.sortvalues.

values_context="context"

Translation context for values attribute to separate equals words with different meaning (not required for in-file translations).

display_values="Entry1,Entry2,Entry3"

Список значений отображаемых пользователю. Должно быть одинаковое количество и порядок записей в качестве values и editable должно быть false или не указано. Для символа разделителя используется тот же символ что и для values. Используется в <combo> и <multiselect>.

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 of a checked <check> (default is "yes").

value_off="foobar"

Specify the false value to be entered in the <key> tag of a unchecked <check> (default is "no").

disable_off="true"

Whether the off value of a <check> is disabled in the dialog, i.e., only unset or yes are provided.

editable="false"

Отключает возможность ввести произвольный текст в качестве значение тега в combo box. Default is "true", which means, the user can add other values as text.

use_last_as_default="true|false|force"

Для <combo>, <multiselect> или <text> последние значения используются по умолчанию. С помощью "force" усиливает такое поведение также для уже обозначенных на карте объектов. По умолчанию это "false".

rows="count"

Определяет максимальное количество строк для отображения записей в <multiselect> (если не обозначено, то автоматически определяется Java).

name_template="template", name_template_filter="search expression"

Custom name formatter for osm primitives matching this preset. Смотрите ниже #name_templatedetails for details.

match="none|key|key!|keyvalue|keyvalue!"

Allows to change the matching process, i.e., determining whether the tags of an OSM object fit into this preset. If a preset fits then it is linked in the Tags/Membership dialog.

none: neutral, i.e., do not consider this item for matching
key: positive if key matches, neutral otherwise
key!: positive if key matches, negative otherwise
keyvalue: positive if key and value matches, neutral otherwise
keyvalue!: positive if key and value matches, negative otherwise

Note that for a match, at least one positive and no negative необходимо. Default is "keyvalue!" for <key> and "none" for <text>, <combo>, <multiselect> and <check>.

id="unique_identifier": Уникальный идентификатор для chunck
ref="unique_identifier": Уникальный идентификатор (должен быть заранее определен) для включаемого шаблона
columns="a number": Количество столбцов для групировки флажков
requisite="optional|required": Если член отношения необязателен или не требуется. По умолчанию "optional".
count="a number": How often can a role occur (if not given unlimited number is assumed)
member_expression="an expression": an expression (cf. search dialog) for objects of this role
preset_name="exact_name": Точное название для заготовки в ссылке.
preset_name_label="false|true": Whether to insert "[preset name]" метка в диалоговом окне (по умолчанию "false" для обеспечения обратной совместимости с внешними заготовками).
length="a number": Длинна ячеки для <text> или <combo> box (number - количество символов).
alternative_autocomplete_keys="some_key(s)": Разделенный запятыми список альтернативных ключей используемых для автоприращения <text>.
auto_increment="-2,-1,+1,+2": Отображаемые значения для автоприращения разделенных запятыми с целым шагом или дискретно, например "-2,-1,+1,+2". Кнопка будет отображаться рядом с <text> полем для каждого значения. Существует также кнопка для отмены автоприращения. По умолчанию автоприращение отключено. Взаимоисключаемо с use_last_as_default.
delimiter="special character": Символ для разделения значений ключа. В <combo> по умолчанию запятая. In case of <multiselect> the default is semicolon and this will also be used to separate selected values in the tag. More information see <multiselect>.
short_descriptions=""Entry1,Entry2,Entry3": Список разделенных текстов, которые будут отображаться под каждым display_value. (Только если нет возможности описать значение ключа в два-три слова.) Instead of comma separated list instead using values, display_values and short_descriptions, the following form is also supported: <list_entry value="" display_value="" short_description="" icon="" icon_size="" />
values_searchable="true|false": Whether to search in <combo> or <multiselect> (display_)values when searching for presets.

name_template детали

Name templates can be used to define custom formatting for OSM primitives or GPX waypoints (для примера в Отношениях или the Selection).

<?xml version="1.0" encoding="UTF-8"?>
<presets>
        <item name="Public transportation" type="relation"
                name_template="Bus({operator} {ref} ?{'{from} - {via} - {to}' | '{from} - {to}' | '{from}' | '{to}'})"
                name_template_filter="type=route route=bus">
        </item>
</presets>

Примеры

Template	Tags	Result
`House number {addr:housenumber}`	`addr:housenumber=10`	House number 10
`?{ 'House number {addr:housenumber} at {addr:street}' \| 'House number {addr:housenumber}' }`	`addr:housenumber=10`	House number 10
	`addr:housenumber=10 addr:street=Abbey road`	House number 10 at Abbey road
`?{ admin_level = 2 'NUTS 1' \| admin_level = 4 'NUTS 2' \| admin_level = 6 'NUTS 3' \| 'Admin level {admin_level}'}`	`admin_level=4`	NUTS 2
	`admin_level=5`	Admin level 5
`{admin_level} - {name} !{parent() type=boundary '?{'(part of {admin_level} - {name})' \| ''}'}`	`admin_level=6 name=Vysocina`, member of relation `admin_level=4 name=Jihovychod`	6 - Vysocina (part of Jihovychod)
	`admin_level=2 name=Czech republic` (no parents)	2 - Czech republic

Синтаксис

{var} - использование значениея переменной var
?{condition1 'value1' | condition2 'value2 | 'value3'} - использовать значение1, если условие1 выполнено, value3 is no condition is satisfied. Состояние может быть либо явным - the same expression as in search or filters is used - или неявным; значение используется, когда все переменные, используемые внутри существуют
!{search_expression 'template'} - search_expression is evaluated and first matching primitive is used as context for template. Полезно, например, чтобы получить теги родительского отношения.

Доступные значения

Для форматирования OSM примитивов , может быть использовано значение любого тега. Вы можете использовать {special:everything}, чтобы увидеть какие значения доступны для GPX путевых точек..

Некоторые дополнительные переменные доступны через специальный префикс:

{special:everything} prints all available values, available for formatting of both primitives and waypoints.
{special:id} prints the ID of an osm primitive
{special:localName} prints the localized name, that is the value of name:lang for your language if it is available or the value of the name tag if it doesn't.

Устаревшие атрибуты

Следующие атрибуты являются устаревшими и больше не поддерживаются в JOSM:

delete_if_empty="true": Был удалён в [5155]. Вы можете просто удалить этот атрибут, если он до сих пор используется в вашей заготовке.
required="true": Заменён атрибутом match с [5155]

Перевод

Для поддержки переводов, все текстовые элементы ("name", "text", "display_values") также могут быть локализованы. (Т.е. "ru.name" будет загружаться в случае выбора русского языка в интерфейсе программы.)

In JOSM internally (internal preset) all "name", "text" and "display_values" are translated when no specific translation has been given in XML file. When no "display_values" are supplied, then "values" will be treated as "display_values" and translated instead. When translations of equal words but different meanings may conflict, a translation context should be specified. Use "name_context", "text_context" or "values_context" for this. The context should be a meaningful short description to help translators.

The translation for the internal preset is done at Launchpad (and will probably change to another service in the future, since the Launchpad web interface often produces timeout errors, see #8645).

Icon handling

See Styles.