| 9 | | [[Image(source:trunk/images/dialogs/mapstyle.png,middle,margin-right=20)]] |
| 10 | | The JOSM [[Help/MapView|map display]] can be easily customized with different styles. Many styles are included with JOSM by default. There are base styles (e.g. [source:trunk/styles/standard/elemstyles.mapcss JOSM standard] or [source:trunk/styles/standard/potlatch2.mapcss Potlatch 2]) that cover a wide range of features each. They can be combined with ''add-on styles'' that cover more special topics (see the [[#Availablestyleslist|Available styles list]] below). Further customization is possible via style options, see section [[#AdvancedPreferences|section Advanced Preferences]]. |
| | 5 | [[JOSMImage(dialogs/mapstyle,middle,margin-right=20,48,link=)]] The JOSM [wikitr:/Help/MapView map display] can be easily customized with different styles. Many styles are included with JOSM by default. |
| | 6 | |
| | 7 | There are ''base styles'' (e.g. [source:/trunk/resources/styles/standard/elemstyles.mapcss JOSM standard] or [wiki:/Styles/Potlatch2 Potlatch 2]) that cover a wide range of features each. They can be combined with ''add-on styles'' that cover more special topics. See the [#Availablestyleslist available styles list] below. |
| | 8 | |
| | 9 | Further customization is possible via [#AdvancedPreferences style options] or by [#CreateStyle creating your own style]. |
| 23 | | ==== Activating more styles ==== |
| 24 | | To add more styles to your list of "active styles" |
| 25 | | 1. open the [Help/Preferences/Map#MapPaintStyles Map Paint Styles Preferences] by either |
| 26 | | * clicking the [[Image(source:trunk/images/dialogs/mappaintpreference.png)]] [[Help/Dialog/MapPaint#MapStyleSettings|Settings]] button in the map style dialog or via |
| 27 | | * [[Help/Menu/View|"View" menu]] ( → "Map paint styles" → "Map paint preferences") or |
| 28 | | * (less comfortable) via the general preferences window (Menu Edit → Preferences → [[Image(source:trunk/images/preferences/map.png,15)]] Map Settings (3rd button on the left) → Map Paint Styles (2nd tab)) |
| 29 | | 2. select a style in the (left) list of "available styles" |
| 30 | | 3. activate it by clicking the [[Image(source:trunk/images/preferences/activate-right.png)]] blue right arrow button in the center |
| 31 | | 4. exit and confirm by clicking the OK button |
| | 24 | 1. Open the [wikitr:/Help/Preferences/MapPaintPreference Map Paint Styles preferences] |
| | 25 | * via the header of the Map Paint Styles panel with the [[JOSMImage(dialogs/mappaintpreference)]] [wikitr:/Help/Dialog/MapPaint#MapStyleSettings Preferences] button or [[Image(addstyle.gif,right,250px,title=animation of how to activate and choose an example style,margin=10,link=)]] |
| | 26 | * via [wikitr:/Help/Menu/View View menu] → ''Map paint styles'' → ''Map paint preferences'' or |
| | 27 | * via the general preferences dialog [wikitr:/Help/Menu/Edit Menu Edit] → [wikitr:/Help/Action/Preferences Preferences] → [[JOSMImage(dialogs/mapstyle,24,middle,link=)]] [wikitr:/Help/Preferences/MapPaintPreference Map Paint Styles] |
| | 28 | 1. Choose a style in the list of ''Available styles'' (left side) |
| | 29 | 1. Activate it by clicking the [[JOSMImage(preferences/activate-right)]] blue right arrow button between the lists. |
| | 30 | 1. Exit and confirm by clicking the OK button |
| 62 | | * Either edit [[StylesSource|this wiki page]] and add URLs for new style files to the list at the top. |
| 63 | | * **Note**: Only URLs with file-extension (e.g. *.mapcss, *.xml, *.zip, *.php) are supported. |
| 64 | | * Or create a wiki page similar to [[Styles/LegacyStandard]] (XML) or [[Styles/Modified]] (MapCSS). |
| 65 | | * for automatical version adjustment you can use two internal variables ({{{"1.[[revision]]_[[date]]" --> 1.13_2011-02-24}}}): |
| 66 | | 1. {{{[[revision]]}}} - is the latest version number of the wiki page |
| 67 | | 1. {{{[[date]]}}} - is the date of the last edit |
| 68 | | * **Note**: Spam filter prohibits adding many external (icon) links. Please, if possible, attach icons to the wiki page ([#Iconhandling see below]). |
| 69 | | In both cases, the new style will be automatically listed in the table above after a few minutes. Then it will also be available in the JOSM mappaint preferences (after clicking the reload button). |
| | 54 | * Either create a wiki page similar to [wiki:Styles/Modified]. |
| | 55 | I. go to [wiki:Styles/MyStyleName https://josm.openstreetmap.de/wiki/Styles/MyStyleName] |
| | 56 | A. change the URL so it matches the name of your style; change only the last part after `...Styles/`, (preferred is CamelCase) |
| | 57 | a. press `Enter` after adjusting the name |
| | 58 | 1. don't forget to enclose your mappaint code by a code block (`#!style type="mapcss"` needs to be on a **new line** after `{{{`): |
| | 59 | {{{ |
| | 60 | {{{ |
| | 61 | #!style type="mapcss"` |
| | 62 | … |
| | 63 | }}} |
| | 64 | }}} |
| | 65 | 1. for automatic version adjustment you have to use `[[revision]]_[[date]]` in your version variable: |
| | 66 | * `[[revision]]` - is the latest version number of the wiki page |
| | 67 | * `[[date]]` - is the date of the last edit of the wiki page |
| | 68 | * recommended usage: `version="1.[[revision]]_[[date]]"` (converts to e.g. `1.13_2019-02-24`) |
| | 69 | * this is required for an automatic update within JOSM |
| | 70 | * **Note**: Spam filter prohibits adding many external (icon) links. Please, if possible, attach icons to the wiki page ([#Iconhandling see below]). … |
| | 71 | * '''or''' edit the page StylesSource and add URLs for new style files to the list at the top. (JOSM wiki based Styles (see above) is the preferred method.) |
| | 72 | * **Note**: Only URLs with file-extension (e.g. *.mapcss, *.zip, *.php) are supported. |
| | 73 | In both cases, the new style will be automatically listed in the table above after a few minutes. Then it will also be available in the JOSM mappaint preferences (after clicking the reload button). \\ |
| | 74 | **Note**: The [/jenkins/job/JOSM-Integration/ JOSM-Integration test] will run on all styles and report problems. |
| 77 | | * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory). |
| 78 | | * Use a path relative to your local style file. |
| 79 | | * New icons can be directly referenced using a http-link. These are downloaded and cached internally. |
| 80 | | * Since JOSM revision [/changeset/2289/josm 2289] zip files are supported. |
| 81 | | * The zip file must contain at least one file with extension xml (or mapcss). |
| | 85 | * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's [source:/trunk/resources/images internal image directory]). |
| | 86 | * Use a path relative to your local style file. (This works only for Styles, not for Presets.) |
| | 87 | * Use a path relative to a directory specified at the bottom in the [wikitr:/Help/Preferences/MapPaintPreference Map Paint Styles preferences] or [wikitr:/Help/Preferences/TaggingPresetPreference Tagging Presets preferences].) |
| | 88 | * New icons can be directly referenced using a https- or http-link. These are downloaded and cached internally. |
| | 89 | * zip files are supported too. |
| | 90 | * The zip file must contain at least one file with extension mapcss (for styles) or xml (for presets). |
| 83 | | * If there are multiple XML files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive). |
| 84 | | * Since JOSM revision [/changeset/4713/josm 4713] inline encoding as described in [[http://tools.ietf.org/html/rfc2397|RFC 2397]] is supported. |
| 85 | | * Example for PNG: {{{data:image/png;base64,...databytes...}}} |
| 86 | | * Example for SVG: {{{data:image/svg+xml;base64,...databytes...}}} |
| 87 | | * [wiki:Help/Base64 More information] about {{{data:image/...}}} in JOSM. |
| 88 | | * When the JOSM wiki is used for designing of new styles you have some additional options: |
| | 92 | * If there are multiple files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive). |
| | 93 | * Inline encoding as described in [https://tools.ietf.org/html/rfc2397 RFC 2397] is supported too. |
| | 94 | * Example for PNG: `data:image/png;base64,...databytes...` |
| | 95 | * Example for SVG: `data:image/svg+xml;base64,...databytes...` |
| | 96 | * [wikitr:/Help/Base64 More information] about `data:image/...` in JOSM. |
| | 97 | * When the JOSM wiki is used for designing of new styles or presets you have some additional options: |
| | 103 | == Translation == |
| | 104 | Styles, Rules, Presets and Plugins use the same translation mechanism as JOSM core. The files must be delivered as Zip and contain a directory called `data` with the .lang files. |
| | 105 | To create these files there exist scripts in the SVN directory [source:osm/applications/editors/josm/i18n/ i18n]. |
| | 106 | See also [wikitr:/Translations#Software software translation section] in translation documentation. |
| | 107 | |
| | 108 | == Updating styles in JOSM == |
| | 109 | Once a style was updated in the wiki (or another external source) it takes up to 10 days until the style gets updated in JOSM automatically (#8933). To immediately force an update you can do the following steps: |
| | 110 | * Open the [wikitr:/Help/Action/Preferences Preferences] |
| | 111 | * Make sure [wikitr:/Help/ExpertMode Expert mode] is enabled |
| | 112 | * Open the [wikitr:/Help/Preferences/Advanced Advanced Preferences] |
| | 113 | * Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Styles/` (or `mirror.` for other external sources) |
| | 114 | * Select the style you want to update |
| | 115 | * Click on Reset at the bottom of the window |
| | 116 | * Click on OK to save the changes (and to close the preference window) |
| | 117 | * Restart JOSM |
| | 118 | |
| | 119 | or: |
| | 120 | |
| | 121 | * Remove the content of your [wikitr:/Help/Action/About#InstallationDetails <josm.cache>] folder |
| | 122 | * Restart JOSM |
| | 123 | |
| | 124 | To check the version of the style in JOSM do the following steps |
| | 125 | * Open the [wikitr:/Help/Dialog/MapPaint Map Paint Styles Dialog] |
| | 126 | * Right click on a style |
| | 127 | * Choose Info |
| | 128 | * Click on Source Tab |
| | 129 | * Search for `version:` at the beginning of the source code |
| 107 | | [[Image(Mappaint_no_icon.png)]] missing icon[[br]] |
| 108 | | We don't have the right icon for every node tag in map features yet, e.g. icons for most {{{natural=*}}} tags are still missing. If you encounter such a "missing icon", feel free to create a nice 16*16 pixel icon that matches the tag. To submit your work, open a [/newticket new ticket] and add your image or zip archive as attachment. |
| | 143 | [[Image(Mappaint_no_icon.png,margin-right=5,link=)]] missing icon \\ |
| | 144 | We don't have the right icon for every node tag in map features yet, e.g. icons for most `natural=*` tags are still missing. If you encounter such a "missing icon", feel free to create a nice 16*16 pixel icon that matches the tag. To submit your work, open a [/newticket new ticket] and add your image or zip archive as attachment. |
| 130 | | * {{{mappaint.showicons}}} |
| 131 | | * select whether icons are shown - same values as {{{mappaint.fillareas}}} |
| 132 | | * {{{mappaint.shownames}}} |
| 133 | | * select whether names are shown - same values as {{{mappaint.fillareas}}} |
| 134 | | * {{{mappaint.strokes}}} |
| 135 | | * select whether strokes or full lines are used - same values as {{{mappaint.fillareas}}} |
| 136 | | * {{{mappaint.useRealWidth}}} |
| 137 | | * true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file |
| 138 | | * false (default) - ways will have the same width on every zoom level |
| 139 | | * {{{mappaint.zoomLevelDisplay}}} |
| | 166 | * `mappaint.showicons` |
| | 167 | * select whether icons are shown - same values as `mappaint.fillareas` |
| | 168 | * `mappaint.shownames` |
| | 169 | * select whether names are shown - same values as `mappaint.fillareas` |
| | 170 | * `mappaint.strokes` |
| | 171 | * select whether strokes or full lines are used - same values as `mappaint.fillareas` |
| | 172 | * ~~`mappaint.useRealWidth`~~ |
| | 173 | * ~~true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file~~ |
| | 174 | * ~~false (default) - ways will have the same width on every zoom level~~ |
| | 175 | * `mappaint.zoomLevelDisplay` |
