Changes between Version 41 and Version 42 of TaggingPresets

Timestamp:

2012-04-05T13:37:40+02:00 (14 years ago)

Author:

simon04

Comment:

updated, deprecate XML Format description and refer to defaultpresets.xml

TaggingPresets

@@ -3 +3 @@
 JOSM supports distributed tagging presets. This is a XML config file that describes a GUI for entering tags (or properties, annotations, sometimes called map features). The XML files can be placed anywhere in the web or at the users local file system. Presets can be added by the users at a central page [wiki:Presets].
 
-= Setup =
-Every user can choose to add any url (or filename) into his preferences. An example URL is included in JOSM SVN.
 
-[[Image(josm-preferences1.png)]]
+== Install existing presets ==
+Open [[Help/Action/Preferences]], click [[Image(source:trunk/images/dialogs/mappaintpreference.png)]], select the tab **Tagging Presets**.
 
+Then add **available presets** using [[Image(source:trunk/images/preferences/activate-right.png)]], or include a local preset by clicking on [[Image(source:trunk/images/dialogs/add.png)]].
 
-After the sources are specified (and after a restart), the tagging presets can be selected from the [wiki:Help/Menu/Presets main menu].
-They can also be added to the toolbar under Preferences>[wiki:Help/Preferences/Toolbar Toolbar Customization]
-== Example ==
+Adding presets requires a restart of JOSM. Then the tagging presets can be selected from the [wiki:Help/Menu/Presets main menu].
+They can also be added to the toolbar under [wiki:Help/Preferences/Toolbar Toolbar Customization].
+
+[[Image(TaggingPresets.png)]]
+
+----
+
+== Develop a new preset – Example ==
 Here is an example of how it looks like:
 
 [[Image(tagging_screenshot.png)]]
 
-
 And this is the code that created the example :
 {{{
+#!xml
 <presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
   <item name="Highway">
@@ -24 +29 @@
 
     <text key="name" text="Highway (e.g. M3)" />
-    <combo key="highway" text="Type" values="major,minor" delete_if_empty="true" />
+    <combo key="highway" text="Type" values="major,minor" />
 
     <!-- Highways are usually oneway -->
@@ -35 +40 @@
 }}}
 
+== Develop a new preset – Add to the list of available presets ==
 
-== XML Format description ==
+See [[Presets]].
 
-The tagging preset description is in a very simple XML format.
+
+== Develop a new preset – XML Format description ==
+
+The tagging preset description is in a very simple XML format. 
+
+See the comment section in **[source:trunk/data/defaultpresets.xml defaultpresets.xml]** for the **valid format description**.
+
+----
+
+== Develop a new preset – XML Format description (outdated!) ==
 
 === Tags ===
@@ -103 +118 @@
  '''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.
@@ -121 +134 @@
  '''use_last_as_default="true"'''::
    For combo boxes or text fields the last value is used as default. Using "force" enforces this behaviour also for already tagged objects.
- '''required="true"'''::
-   Preset is not valid unless value for this key is entered. Used by PropertiesDialog to show list of presets for selected object. 
  '''rows="count"'''::
    Specify the number of rows in multiselect entry.
@@ -137 +148 @@
   * 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).
-