Changes between Version 57 and Version 58 of TaggingPresets

Timestamp:

2014-10-29T11:29:12+01:00 (9 years ago)

Author:

stoecker

Comment:

Copy first set of information from XML

TaggingPresets

@@ -39 +39 @@
 == 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**.
+The tagging preset description is in a very simple XML format.
+
+See the **[source:trunk/data/defaultpresets.xml defaultpresets.xml]** for an example covering all possibilities.
 
 The full XSD schema is available at the namespace URI (http://josm.openstreetmap.de/tagging-preset-1.0) as well as [source:trunk/data/tagging-preset.xsd the source repository].
@@ -67 +67 @@
    Used to group items in sub menus. ''name'' is required, ''icon'' is optional attribute.
  '''<item>'''::
-   Every item is one annotation set to select from. ''name'' is required, ''icon'' is optional attribute.
+   Every item is one annotation set to select from. ''name'' is required, ''type'' is recommended, ''icon'' is optional attribute.
  '''<separator/>'''::
    Insert a line separator into the menu.
@@ -76 +76 @@
    Used to group some optional elements of an item. Possibly equivalent to <label text="Optional Attributes:"/>
  '''<space />'''::
-   Add some space (ie a newline) in the preset display. Possibly equivalent to <label text=" "/>
+   Add some space (ie a newline) in the preset display.
  '''<link>'''::
    Specify a web link for this feature or to anything else of use. The ''href'' attribute is required.
@@ -104 +104 @@
    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.
+   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. The icon should be quadratic in size. See [[Styles#Iconhandling]] how icons can be specified.
  '''key="some_key"'''::
    This specifies the property key that will be modified by the item.
@@ -146 +146 @@
 === Format description from XML document (needs to be joined with above texts) ===
 
+{{{
 item:
   name: the text to display
@@ -157 +158 @@
                      (defaults to "false" for backward-compatibility on external presets)
 
-group: a group of items (same syntax as "item")
-
-link: link to the relating map features website
-  href: the URL
-
 preset_link: a link to an other preset
   preset_name: the exact name of the preset to link to
@@ -170 +166 @@
   icon_size: maximal size of icon (optional). If no value is given, default is 16px
 
-space: empty line
-
 optional: optional tags, short for "space" plus "label" plus "space"
   text: the text to display (defaults to "Optional Attributes:")
-
-separator: separator line in menus
 
 item_separator: horizontal separator line between items (in window)
@@ -299 +291 @@
  - keyvalue!: positive if key and value matches, negative otherwise
 Note that for a match, at least one positive and no negative is required.
+}}}
 
 === Icon handling ===