Search:
Login
Preferences
Help/Guide
About Trac
Register
Forgot your password?
Wiki
Timeline
Changelog
Browse Source
View Tickets
New Ticket
Roadmap
Builds
Sonar
Search
Context Navigation
+0
Start Page
Index
History
Editing Ru:TaggingPresets
Adjust edit area height:
8
12
16
20
24
28
32
36
40
Edit side-by-side
''Если вы хотите узнать шаги по установке заготовок тегов, смотрите [Help/Preferences/Map#TaggingPresets "Tagging Presets" tab in Preferences > Map Settings]''[[br]] ''Если вы хотите использовать заготовки тегов или необходима ссылка на заготовку, смотрите [wiki:Presets Presets]''[[br]] ''If you want to add the preset to the list of available presets see [[Extend JOSM#Custompresetsandpublication]]'' [[TranslatedPages(revision=1,outdated=Эта страница находится в процессе перевода или помечена для этой цели. Может содержать ошибки и непереведённые фрагменты)]] [[PageOutline(2-10,Table of Contents)]] = Заготовки тегов = JOSM поддерживает distributed заготовки тегов. Это XML файл, описывающий графический интерфейс для ввода тегов (или свойства, аннотации, иногда называемый картой функции). Предварительные настройки могут быть размещены в любом месте в интернете или у пользователей в локальной файловой системе. JOSM может быть настроен на использование пользовательских локальных или удаленных заготовок тегов. == Разработка новой заготовки == Заготовки тегов описываются в очень простом XML файле. Подробнее смотрите [#XML ниже]. Смотрите для примера **[source:trunk/data/defaultpresets.xml defaultpresets.xml]**, охватывающий большую часть возможностей, перечисленных ниже. Пример: [[Image(Change 1 object.png,align=right)]] {{{ #!preset <?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> }}} == Описание XML формата ==#XML Полная схема XSD доступна по следующей ссылке (http://josm.openstreetmap.de/tagging-preset-1.0) а также [source:trunk/data/tagging-preset.xsd the source repository]. === Теги === ==== Вводная часть ==== <presets>:: Должен быть основным тегом файла. Поддерживает следующие атрибуты: * '''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). [[BR]] ==== Коментарии ==== <!-- это пример комментария -->:: Документ может содержать встроенные комментарии. [[BR]] ==== Создание группы заготовок ==== <group>:: Используется для группировки элементов в меню. `name` необходимо, `icon` необязательный атрибут. <item>:: Every item is one annotation set to select from. `name` необходимо, `type` и `preset_name_label` рекомендуются, `icon` and `name_template` необязательные атрибуты. <separator/>:: Добавляет горизонтальную разделительную линию в меню. [[BR]] ==== 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` необходим. [[BR]] ==== Установка фиксированного значения у ключа ==== <key>:: Этот тег позволяет присвоить какому-либо ключу определённое значение. `key` необходим и, если `value` присутствует, то ключ будет установлен. Если `value` отсутствует, то ключ удаляется. `match` является необязательным атрибутом. [[BR]] ==== Атрибуты диалоговых окон ввода и выбора ==== <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> могут быть отредактированы как если бы они были текстовыми полями (в дополнение к выпадающему списку). Недоступные для редактирования блоки <combo> могут содержать только одно из указанных значений или ничего. <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) и записываются в значение тега. Если значение тега уже назначено, то, при открытии диалогового окна, 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` необязательные атрибуты. [[BR]] ==== Шаблоны ==== <chunk>:: Используется для того, чтобы определить шаблон элементов для последующего (многократного) использования. Атрибут `id` обязателен. <reference>:: Используется, чтобы вставить ссылку на ранее определённый шаблон. Атрибут `ref` обязателен. [[BR]] === Атрибуты === Атрибуты тегов имеют следующие значения: name="a_name":: Указывается имя для элемента. Это имя будет использоваться в графическом интерфейсе для отображения в заготовках тегов. name_context="context":: Контекстный перевод `name` атрибутов, чтобы отличить слова с одинаковым написанием, но различным значением (not required for in-file translations).. type="data_type":: Если используется, то только с перечисленными объектами может работать заготовка. Могут быть "node", "way", "closedway", "multipolygon", "relation" или любое разделённое запятой их сочетание. Обратите внимание, что "multipolygon" не включается в "relation", поэтому, если preset should apply for multipolygons and other relation types, you need to specify both: "multipolygon,relation". Также используется в теге <role>, чтобы указать, какие типы объектов разрешены для конкретного члена отношения. icon="iconname":: Имя файла или ссылка для иконки. Изображение будет использоваться в качестве значка для отображения в списке выбора и при добавлении заготовки на панель инструментов. Иконки могут быть использованы в <item>, <label> и <list_entry>. Значок должен быть квадратными по размеру. См. [[Styles#Iconhandling]] как могут быть указаны иконки. icon_size="a number":: Максимальный размер иконки в пикселях px. Если значение не задано, то используется значение по умолчанию 16x16 px для <list_entry /> (в <combo> и <multiselect>). key="some_key":: Определяет свойство ключа, который будет изменен с помощью элемента. В случае с <role> это name role используемое в отношении. text="Any text":: Текст, который будет отображаться перед (при использовании в <check> - после) элементом в графическом интерфейсе пользователя. Также используется для <label> и <optional>. text_context="context":: Контекстный перевод атрибутов `text`, чтобы отличить слова с одинаковым написанием, но различным значением (not required for in-file translations). default="default_value":: Значение по умолчанию для данного элемента. Если пользователем не указано значение для ключа, то текущее значение ключа выбирается по умолчанию (если это применимо). При использовании в <check> - установлен ли флажок или нет по умолчанию (по умолчанию "off"). При использовании в <text>, <combo> и <multiselct> по умолчанию "". values="entry1,entry2,entry3":: Список значений для <combo> и <multiselect>). Значения должны быть разделены запятыми (для <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":: Отключит internationalisation для значения, чтобы избежать ошибок. См. #11696. По умолчанию "false". Используется в <combo> и <multiselect>. (Полезно, например, для часов работы или названия торговых марок..) values_sort="false":: Значения в <combo> и <multiselect> сортируются по алфавиту на всех языках. С помощью этого атрибута вы можете отключить алфавитную сортировку, если значения должны перечисляться в заданном порядке. См #5509 и #11926. (В JOSM согласно внутренним настройкам по умолчанию для "smoothness" и "trail_visibility".) По умолчанию "true". Пользователи могут глобально отключить сортировку с помощью ключа `taggingpreset.sortvalues`. values_context="context":: Контекстный перевод атрибутов `values`, чтобы отличить слова с одинаковым написанием, но различным значением (not required for in-file translations) display_values="Entry1,Entry2,Entry3":: Текст отображаемый пользователю в качестве значений. Должно быть одинаковое количество и порядок записей в качестве `values` и `editable` должно быть false или не указано. Для символа разделителя используется тот же символ что и для `values`. Используется в <combo> и <multiselect>. Например: если для value="24/7" указать display_value="Круглосуточно", то для пользователя будет показан текст "Круглосуточно" вместо "24/7". value="foobar":: Укажите значение, которое будет назначено для тега <key>. value_on="foobar":: Укажите значение, которое будет назначено для тега <key>, при установке флажка в <check> (по умолчанию "yes"). value_off="foobar":: Укажите значение, которое будет назначено для тега <key>, при снятии флажка в <check> (по умолчанию "no"). disable_off="true":: Использование данного атрибута в <check> позволяет удалять тег <key> вместо назначения ему параметра "no" при снятии флажка в диалоговом окне. editable="false":: Отключает возможность ввести произвольный текст в качестве значение тега в поле <combo>. По умолчанию "true", что означает, что пользователь может добавить другие значения в виде текста. 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!":: Позволяет изменить метод сопоставления, т.е. определяет подходят ли теги объектов заготовке. Если заготовка подходит, то она linked in the [wiki:Help/Dialog/TagsMembership Tags/Membership dialog]. * none: neutral, т.е. не рассматривать этот пункт для сопоставления * key: positive если key соответствует, в противном случае neutral * key!: positive если key соответствует, в противном случае negative * keyvalue: positive если key и value соответствуют, в противном случае neutral * keyvalue!: positive если key и value соответствуют, в противном случае negative Обратите внимание, что для match необходим по крайней мере один positive и нет negative. По умолчанию это "keyvalue!" для <key> и "none" для <text>, <combo>, <multiselect> и <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`. (Только если нет возможности описать значение ключа в два-три слова.) Вместо стандартного метода перечисления значений с использованием запятой в качестве разделителя `values`, `display_values` и `short_descriptions`, можно использовать следующий способ записи: `<list_entry value="" display_value="" short_description="" icon="" icon_size="" />` values_searchable="true|false":: Whether to search in <combo> and <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 <?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 ([source:josm/trunk/data/defaultpresets.xml 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 [https://translations.launchpad.net/josm/trunk 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 [wiki:Styles#Iconhandling Styles]. == See also == * [wiki:Help/Menu/Presets Presets menu]
Note:
See
WikiFormatting
and
TracWiki
for help on editing wiki content.
Change information
Your email or username:
E-mail address and name can be saved in the
Preferences
Comment about this change (optional):
Attachments
(1)
Change 1 object.png
(
31.2 KB
) - added by
Neufoxet
8 years ago
.
Download all attachments as:
.zip
Note:
See
TracWiki
for help on using the wiki.