Changes between Version 74 and Version 173 of Presets


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Presets

    v74 v173  
    1 {{{
    2 #!comment
    3 This contains the list of external preset addresses.
    4 It will be parsed about each 10 minutes and is used to update the preset list.
     1[[TranslatedPages]]
    52
    6 http://openstreetmap.pl/kendzi/preset/current/roofspresets.xml
    7 http://osmtools.de/josm/steps.xml
    8 http://dev.openseamap.org/josm/Presets_Hafen.xml
    9 http://dev.openseamap.org/josm/Presets_Sport.xml
    10 http://www.freietonne.de/ft_icons/josm/FreieTonne_rules_presets_zip.php
    11 http://osm.michis-pla.net/presets/observatory.xml
    12 http://sites.google.com/site/towardsfloss/Home/doctor_presets_el.xml
    13 http://somewhere.dk/email/josm/source.xml
    14 http://www.schoenitzer.de/test/pavement.xml
    15 http://textual.ru/irs.xml
    16 https://raw.github.com/molysgaard/OAM-JOSM/master/oam-presets.xml
    17 http://somewhere.dk/email/josm/tower/tower.xml
     3= Presets =
     4
     5[[JOSMImage(dialogs/propertiesdialog,48,link=,margin-right=20,margin-bottom=10,middle,left)]]
     6
     7''If you want to learn installation steps for presets, see [[JOSMImage(dialogs/propertiesdialog)]] [wikitr:/Help/Preferences/TaggingPresetPreference Tagging Presets] register in [[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences Preferences]'' \\
     8''If you want to extend presets with your own see - [wikitr:/TaggingPresets TaggingPresets]''
     9
     10[[PageOutline(2-10,Table of contents)]]
     11 \\
     12
     13== What are presets? ==
     14**Presets** in JOSM are menu-driven shortcuts to tag common object types in OpenStreetMap. They provide you with a user friendly interface to edit one or more objects at a time, suggest additional keys and values you may wish to add to those objects, and most importantly, prevent you from having to enter keys and values by hand.
     15
     16There are three types of Presets available to you in JOSM. Adding or removing any of these items requires restarting JOSM.
     171. The **Internal Preset** list, defined in [source:/trunk/resources/data/defaultpresets.xml defaultpresets.xml], is the default set of presets available in the JOSM [wikitr:/Help/Menu/Presets Presets] menu. Changes to the Internal Presets requires modification of the JOSM source code.
     181. JOSM user-community created (and published) **Available presets**, which can be enabled through the [wikitr:/Help/Preferences/TaggingPresetPreference Tagging Presets] register in Preferences. The full list of these Available presets, and how to publish a new one you create, appears below.
     191. **Custom Tagging Presets** files, for cases where you want to use customized Presets but they are not published to JOSM as an Available preset. Customized presets can be added through the [wikitr:/Help/Preferences/TaggingPresetPreference Tagging Presets] register in Preferences, either by URL, or by filename on your local filesystem. The format of a Custom Tagging Presets .xml file appears at [wikitr:/TaggingPresets TaggingPresets].
     20
     21== JOSM Available presets ==
     22[[Styles(en|presets|short description|author|description|version|More details)]]
     23
     24== Publish a new Available presets item ==#PublishanewAvailablepresetsitem
     25[=#Createnewpresets]
     26{{{#!comment
     27Deprecated #Createnewpresets target is called from some PresetsSource and DevelopersGuide/DefaultPresets pages
    1828}}}
     29See [wikitr:/TaggingPresets] for the syntax of customized preset files. Be sure to validate a preset file before publishing it!
     30
    1931{{{
    2032#!comment
    2133Note for translators:
    22  - The above list and this note can be stripped from translation.
    23 }}} 
     34 - The reference below to change the source of this page should not be modified, so it tells the reader to modify the English page.
     35}}}
    2436
    25 [[TranslatedPages]]
    26 = JOSM presets =
    27 [[Styles(en|presets|short description|author|description|version|More details)]]
     37=== JOSM wiki Available preset (preferred method) ===
     38In order to add a new wiki based preset, simply create a new wiki page similar to the [#List existing wiki presets].
     39 I. go to [wiki:Presets/MyPresetName https://josm.openstreetmap.de/wiki/Presets/MyPresetName]
     40  A. change the URL so it matches the name of your preset; change only the last part after `...Presets/`, (preferred is CamelCase)
     41  a. press `Enter` after adjusting the name
     42 1. click 'create this page'
     43 1. add content similar to existing preset wikis, e.g. [wikitr:/Presets/OneClick]
     44 1. don't forget to enclose your preset code by a code block (`#!preset` needs to be on a **new line** after `{{{`):
     45  1. `{{{`
     46  1. `#!preset`
     47  1. `<?xml version="1.0" encoding="UTF-8"?>`
     48  1. ...
     49  1. `}}}`
     50 1. save the wiki page
     51 1. after a few minutes the new wiki preset will show up in the list and in JOSM automatically
     52 1. for automatic version adjustment you have to use `[[revision]]_[[date]]` in your version variable:
     53  * `[[revision]]` - is the latest version number of the wiki page
     54  * `[[date]]` - is the date of the last edit of the wiki page
     55  * recommended usage: `version="1.[[revision]]_[[date]]"` (converts to e.g. `1.13_2019-02-24`)
     56  * this is required for an automatic update within JOSM
    2857
    29 == Installation ==
    30 The presets listed above can be selected and activated within [wiki:Help/Preferences/Map map settings] in the JOSM preferences.
     58=== Externally hosted Available preset ===
     59A new externally hosted preset URLs can be published by editing [wikitr:/PresetsSource this page]. \\
     60**Note**: Only URLs with file-extension (e.g. *.mapcss, *.xml, *.zip, *.php) are supported.
    3161
    32 == Create new presets ==
    33 See also [wiki:TaggingPresets] or [http://josm.openstreetmap.de/svn/trunk/data/defaultpresets.xml standard preset] in case you want to create own files.
    34 {{{
    35 #!comment
    36 Note for translators:
    37  - The reference below to change the source of this page should be modified, so it tells the reader to modify the English page.
    38 }}}
    39 New external hosted preset URLs can be entered when editing this page. New wiki based presets can be created when making a page similar to the already existing pages listed below.
     62=== Icon handling in Available presets ===#IconHandling
     63* See [wikitr:/Styles#Icons] for a description how attached files and icons are handled.
     64* Empty image paths like `icon=""` are not allowed.
    4065
    41 See [wiki:Styles] for a description how the JOSM wiki helps to create own styles or presets and how attached files are handled.
    4266
    43 == Presets managed in JOSM wiki ==
     67== Updating Available presets in JOSM ==
     68Once a preset was updated in the wiki (or another external source) it takes up to 10 days until the preset gets updated in JOSM automatically. To immediately force an update you can do the following steps:
     691. Open the [wikitr:/Help/Action/Preferences Preferences]
     701. Make sure [wikitr:/Help/ExpertMode Expert Mode] is enabled
     711. Open the [wikitr:/Help/Preferences/Advanced Advanced Preferences]
     721. Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Presets/` (or `mirror.` for other external sources)
     731. Select the preset you want to update
     741. Click on Reset at the bottom of the window
     751. Click on OK to save the changes (and to close the preference window)
     761. Restart JOSM
    4477
     78or:
     79
     801. Remove the content of your [wikitr:/Help/Action/About#InstallationDetails <josm.cache>] folder
     811. Restart JOSM
     82
     83
     84== Available presets managed in the JOSM wiki ==#List
    4585[[TitleIndex(Presets/)]]
     86
     87
     88----
     89Back to [wikitr:/Help/Menu/Presets Presets Menu] \\
     90Back to [wikitr:/Help Main Help]