Changes between Version 163 and Version 176 of Presets


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

Legend:

Unmodified
Added
Removed
Modified

  • Presets

    v163 v176  
    55[[JOSMImage(dialogs/propertiesdialog,48,link=,margin-right=20,margin-bottom=10,middle,left)]]
    66
    7  ''If you want to learn installation steps for presets, see [wikitr:/Help/Preferences/Map#TaggingPresets "Tagging Presets" tab in Preferences > Map Settings]''[[br]]
    8  ''If you want to extend presets with your own see - [wikitr:/TaggingPresets TaggingPresets]''[[br]]
    9  ''If you want to publish a new item to the list below - [#PublishanewAvailablepresetsitem follow the instructions below the list]''
     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]''
    109
    1110[[PageOutline(2-10,Table of contents)]]
     11 \\
    1212
    1313== What are presets? ==
    … …  
    1616There are three types of Presets available to you in JOSM. Adding or removing any of these items requires restarting JOSM.
    17171. 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.
    18 1. JOSM user-community created (and published) **Available presets**, which can be enabled through the [wikitr:/Help/Preferences/Map#TaggingPresets "Tagging Presets" tab in Preferences > Map Settings]. The full list of these Available presets, and how to publish a new one you create, appears below.
    19 1. **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/Map#TaggingPresets "Tagging Presets" tab in Preferences > Map Settings] menu, either by URL, or by filename on your local filesystem. The format of a Custom Tagging Presets .xml file appears at [wikitr:/TaggingPresets TaggingPresets].
     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].
    2020
    2121== JOSM Available presets ==
    2222[[Styles(en|presets|short description|author|description|version|More details)]]
    2323
    24 == Publish a new Available presets item ==#Createnewpresets
     24== Publish a new Available presets item ==#PublishanewAvailablepresetsitem
     25[=#Createnewpresets]
     26{{{#!comment
     27Deprecated #Createnewpresets target is called from some PresetsSource and DevelopersGuide/DefaultPresets pages
     28}}}
    2529See [wikitr:/TaggingPresets] for the syntax of customized preset files. Be sure to validate a preset file before publishing it!
     30
    2631{{{
    2732#!comment
    2833Note for translators:
    29  - The reference below to change the source of this page should be modified, so it tells the reader to modify the English page.
     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.
    3035}}}
     36
    3137=== JOSM wiki Available preset (preferred method) ===
    32 * In order to add a new wiki based preset, simply create a new wiki page similar to the [#List existing wiki presets].
    33  * i.e. go to https://josm.openstreetmap.de/wiki/Presets/MyPresetName (Change the URL so it matches the name of your preset. Change only the last part after `...Presets/`.)
    34  * click 'create this page'
    35  * add content similar to existing preset wikis, e.g. [wikitr:/Presets/OneClick]
    36  * don't forget to enclose your preset code by a code block (`#!preset` needs to be on a new line after `{{{`):
    37   * `{{{`
    38   * `#!preset`
    39   * `<?xml version="1.0" encoding="UTF-8"?>`
    40   * ...
    41   * `}}}`
    42  * save the wiki page
    43  * after a few minutes the new wiki preset will show up in the list and in JOSM automatically
    44  * for automatic version adjustment you have to use `[[revision]]_[[date]]` in your version variable:
    45   * {{{[[revision]]}}} - is the latest version number of the wiki page
    46   * {{{[[date]]}}} - is the date of the last edit of the wiki page
    47   * recommended usage: {{{version="1.[[revision]]_[[date]]"}}} (converts to e.g. {{{1.13_2019-02-24}}})
     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  {{{
     46  {{{
     47  #!preset
     48  <?xml version="1.0" encoding="UTF-8"?>
     49  ...
     50  }}}
     51  }}}
     52 1. save the wiki page
     53 1. after a few minutes the new wiki preset will show up in the list and in JOSM automatically
     54 1. for automatic version adjustment you have to use `[[revision]]_[[date]]` in your version variable:
     55  * `[[revision]]` - is the latest version number of the wiki page
     56  * `[[date]]` - is the date of the last edit of the wiki page
     57  * recommended usage: `version="1.[[revision]]_[[date]]"` (converts to e.g. `1.13_2019-02-24`)
    4858  * this is required for an automatic update within JOSM
     59
    4960=== Externally hosted Available preset ===
    50 * A new externally hosted preset URLs can be published by editing [wiki:PresetsSource this page].
    51  * **Note**: Only URLs with file-extension (e.g. *.mapcss, *.xml, *.zip, *.php) are supported.
     61A new externally hosted preset URLs can be published by editing [wikitr:/PresetsSource this page]. \\
     62**Note**: Only URLs with file-extension (e.g. *.mapcss, *.xml, *.zip, *.php) are supported.
    5263
    53 See [wikitr:/Styles#CreateStyle] for a description how the JOSM wiki helps to create own styles or presets and how attached files and icons are handled.
     64=== Icon handling in Available presets ===#IconHandling
     65* See [wikitr:/Styles#Icons] for a description how attached files and icons are handled.
     66* Empty image paths like `icon=""` are not allowed.
    5467
    5568
    5669== Updating Available presets in JOSM ==
    57 Once an Available preset is published, it can take up to 10 days until the item appears in JOSM automatically. To immediately force an update you can perform the following steps:
    58 * Make sure [wikitr:/Help/ExpertMode Expert Mode] is enabled
    59 * Open the [wikitr:/Help/Action/Preferences Preferences]
    60 * Open the [wikitr:/Help/Preferences/Advanced Advanced Preferences]
    61 * Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Presets/` (or `mirror.` for other external sources)
    62 * Select the preset you want to update
    63 * Click on Reset at the bottom of the window
    64 * Click on OK to save the changes (and to close the preference window)
    65 * Restart JOSM
     70Once 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:
     711. Open the [wikitr:/Help/Action/Preferences Preferences]
     721. Make sure [wikitr:/Help/ExpertMode Expert Mode] is enabled
     731. Open the [wikitr:/Help/Preferences/Advanced Advanced Preferences]
     741. Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Presets/` (or `mirror.` for other external sources)
     751. Select the preset you want to update
     761. Click on Reset at the bottom of the window
     771. Click on OK to save the changes (and to close the preference window)
     781. Restart JOSM
     79
     80or:
     81
     821. Remove the content of your [wikitr:/Help/Action/About#InstallationDetails <josm.cache>] folder
     831. Restart JOSM
    6684
    6785
    6886== Available presets managed in the JOSM wiki ==#List
    69 [[TitleIndex(Presets/)]]
     87[[TitleIndexTr(Presets/)]]
    7088
     89Outdated and disabled:
     90
     91[[TitleIndexTr(HistoricPresets/)]]
    7192
    7293----
    73 Back to [wikitr:/Help main help][[BR]]
    74 Back to [wikitr:/Help/Menu/Presets Presets menu]
     94Back to [wikitr:/Help/Menu/Presets Presets Menu] \\
     95Back to [wikitr:/Help Main Help]