| | 3 | <!-- |
| | 4 | Pics have been derived from |
| | 5 | http://de.wikipedia.org/wiki/Bildtafel_der_Verkehrszeichen_in_Deutschland (german street sign SVGs) |
| | 6 | http://commons.wikimedia.org/wiki/Image:National_Park_Service_sample_pictographs.svg (various monochrome pictograms) |
| | 7 | http://www.kde.org |
| | 8 | http://openclipart.org/media/view/media/clip_art |
| | 9 | http://www.sjjb.co.uk/mapicons/ (meanwhile in osm svn) |
| | 10 | --> |
| | 11 | <!-- |
| | 12 | item: |
| | 13 | name: the text to display |
| | 14 | icon: the icon to display |
| | 15 | - relative to the icon path |
| | 16 | - URL's are also supported to allow remote icons (are cached locally) |
| | 17 | type: the data types - way,node,relation,closedway (separated by comma) |
| | 18 | name_template: define custom formatting for OSM primitives |
| | 19 | see http://josm.openstreetmap.de/wiki/NameTemplate |
| | 20 | |
| | 21 | link: link to the relating map features website |
| | 22 | href: the URL |
| | 23 | |
| | 24 | label: simple static text label |
| | 25 | text: the text to display |
| | 26 | |
| | 27 | key: fixed key/value pair to be set |
| | 28 | key: key to set |
| | 29 | value: value to set |
| | 30 | match: none/key/key!/keyvalue (default is "keyvalue", see below for more information) |
| | 31 | |
| | 32 | text: text box |
| | 33 | key: key to set |
| | 34 | text: fixed label to display |
| | 35 | default: default string to display (defaults to "") |
| | 36 | use_last_as_default: true/false/force (default is "false") |
| | 37 | match: none/key/key!/keyvalue (default is "none", see below for more information) |
| | 38 | |
| | 39 | combo: combo box, with multiple choices and possible to enter free form text |
| | 40 | key: key to set |
| | 41 | text: fixed label to display |
| | 42 | values: comma separated list of values |
| | 43 | display_values: comma separated list of values to be displayed instead of the |
| | 44 | database values, order and number must be equal to values |
| | 45 | short_descriptions: comma separated list of texts to be displayed below each |
| | 46 | display_value. (Only if it is not possible to describe |
| | 47 | the entry in 2-3 words.) Instead of comma separeted list |
| | 48 | instead using values, display_values and short_descriptions, the following form is also supported: |
| | 49 | <list_entry value="" display_value="' short_description="" icon=""/> |
| | 50 | default: default string to display (defaults to "") |
| | 51 | use_last_as_default: true/false/force (default is "false") |
| | 52 | match: none/key/key!/keyvalue (default is none, see below for more information) |
| | 53 | |
| | 54 | multiselect: list of values from which zero or more can be selected |
| | 55 | key: key to set |
| | 56 | text: fixed label to display |
| | 57 | delimiter: character that separates values (default: semicolon) - this |
| | 58 | will also be used to separate selected values in the tag. |
| | 59 | values: delimiter-separated list of values (delimiter can be escaped with backslash) |
| | 60 | rows: specify the number of rows to display (default -1) |
| | 61 | display_values: delimiter-separated list of values to be displayed instead of the |
| | 62 | database values, order and number must be equal to values |
| | 63 | short_descriptions: delimiter-separated list of texts to be displayed below each |
| | 64 | display_value. (Only if it is not possible to describe |
| | 65 | the entry in 2-3 words.) Instead of a separated list |
| | 66 | instead using values, display_values and short_descriptions, the following form is also supported: |
| | 67 | <list_entry value="" display_value="' short_description="" icon=""/> |
| | 68 | default: default string to display (defaults to "") |
| | 69 | use_last_as_default: true/false/force (default is "false") |
| | 70 | match: none/key/key!/keyvalue (default is "none", see below for more information) |
| | 71 | |
| | 72 | check: checkbox |
| | 73 | key: key to set |
| | 74 | text: fixed label to display |
| | 75 | default: ticked on/off |
| | 76 | value_on: the value to set when checked (default is "yes") |
| | 77 | value_off: the value to set when unchecked (default is "no") |
| | 78 | match: none/key/key!/keyvalue (default is "none", see below for more information) |
| | 79 | |
| | 80 | role: type to specify possible roles in relations |
| | 81 | key: the role name used in relation |
| | 82 | text: fixed label to display |
| | 83 | requisite: optional/required (default is "optional") |
| | 84 | count: how often can the role occur (if not given unlimited number is assumed) |
| | 85 | type: the data types - way,node,relation,closedway (separated by comma) |
| | 86 | |
| | 87 | presets: For external files <presets> should have following attributes: |
| | 88 | author: the author of the preset |
| | 89 | version: a version number of some sort (e.g. creation date) |
| | 90 | description: what is your preset meant to be |
| | 91 | shortdescription: very short description |
| | 92 | link: a link to a helpful website (optional) |
| | 93 | The fields description, shortdescription and link may also be localized (e.g. de.link) |
| | 94 | |
| | 95 | See also http://josm.openstreetmap.de/wiki/TaggingPresets. |
| | 96 | |
| | 97 | The fields "name", "text", "display_values" may also be localized (e.g. de.name). |
| | 98 | When translations of equal words but different meanings may conflict, a translation |
| | 99 | context should be specified. Use "name_context", "text_context" or "values_context" |
| | 100 | for this. The context should be a meaningful short description to help translators. |
| | 101 | |
| | 102 | In JOSM internally all "name", "text" and "display_values" are translated when |
| | 103 | no specific translation has been given in XML file. When no "display_values" |
| | 104 | are supplied, then "values" will be treated as "display_values" and translated instead. |
| | 105 | |
| | 106 | The match attribute allows to change the matching process, i.e., determining whether |
| | 107 | the tags of an OSM object fit into this preset. |
| | 108 | - none: neutral, i.e., do not consider this item for matching |
| | 109 | - key: positive if key matches, neutral otherwise |
| | 110 | - key!: positive if key matches, negative otherwise |
| | 111 | - keyvalue: positive if key and value matches, negative otherwise |
| | 112 | Note that for a match, at least one positive and no negative is required. |
| | 113 | --> |
