| 8 | | = What are presets? = |
| | 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? == |
| 12 | | 1. The **Internal Preset** list, defined in [https://josm.openstreetmap.de/browser/trunk/data/defaultpresets.xml defaultpresets.xml], is the default set of presets available in the JOSM [https://josm.openstreetmap.de/wiki/Help/Menu/Presets Presets] menu. Changes to the Internal Presets requires modification of the JOSM source code. |
| 13 | | 2. JOSM user-community created (and published) **Available presets**, which can be enabled through the [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. |
| 14 | | 3. **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 [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 [wiki:TaggingPresets TaggingPresets]. |
| | 17 | 1. 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/TaggingPresetPreference Tagging Presets] register in Preferences. 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/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]. |
| 27 | | * In order to add a new wiki based preset, simply create a new wiki page similar to the [#List existing wiki presets]. |
| 28 | | * 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/`.) |
| 29 | | * click 'create this page' |
| 30 | | * add content similar to existing preset wikis, e.g. [wiki:Presets/OneClick] |
| 31 | | * don't forget to enclose your preset code by a code block (`#!preset` needs to be on a new line after `{{{`): |
| 32 | | * `{{{` |
| 33 | | * `#!preset` |
| 34 | | * ... |
| 35 | | * `}}}` |
| 36 | | * save the wiki page |
| 37 | | * after a few minutes the new wiki preset will show up in the list and in JOSM automatically |
| 38 | | * for automatic version adjustment you have to use at least one of the two variables: |
| 39 | | * {{{[[revision]]}}} - is the latest version number of the wiki page |
| 40 | | * {{{[[date]]}}} - is the date of the last edit |
| 41 | | * recommended usage: {{{"1.[[revision]]_[[date]]"}}} (converts to e.g. {{{1.13_2014-02-24}}}) |
| | 38 | In 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 |
| | 57 | |
| 50 | | 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: |
| 51 | | * Make sure [wiki:Help/ExpertMode Expert Mode] is enabled |
| 52 | | * Open the [wiki:Help/Action/Preferences Preferences] |
| 53 | | * Open the [wiki:Help/Preferences/Advanced Advanced Preferences] |
| 54 | | * Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Presets/` (or `mirror.` for other external sources) |
| 55 | | * Select the preset you want to update |
| 56 | | * Click on Reset at the bottom of the window |
| 57 | | * Click on OK to save the changes (and to close the preference window) |
| 58 | | * Restart JOSM |
| | 68 | Once 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: |
| | 69 | 1. Open the [wikitr:/Help/Action/Preferences Preferences] |
| | 70 | 1. Make sure [wikitr:/Help/ExpertMode Expert Mode] is enabled |
| | 71 | 1. Open the [wikitr:/Help/Preferences/Advanced Advanced Preferences] |
| | 72 | 1. Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Presets/` (or `mirror.` for other external sources) |
| | 73 | 1. Select the preset you want to update |
| | 74 | 1. Click on Reset at the bottom of the window |
| | 75 | 1. Click on OK to save the changes (and to close the preference window) |
| | 76 | 1. Restart JOSM |
| | 77 | |
| | 78 | or: |
| | 79 | |
| | 80 | 1. Remove the content of your [wikitr:/Help/Action/About#InstallationDetails <josm.cache>] folder |
| | 81 | 1. Restart JOSM |
