| 6 | | http://maps.tilusnet.com/josmdata/elemstyles_nolabels.xml |
| 7 | | http://www.freietonne.de/ft_icons/josm/FreieTonne_rules_presets_zip.php |
| 8 | | http://github.com/avar/osmis-josm-style/raw/master/elemstyles_is.xml |
| 9 | | http://dev.openseamap.org/josm/seamark_styles.xml |
| 10 | | http://osmalba.org/josm_styles/naptan_bus_stops.zip |
| 11 | | http://github.com/bastik/mapcss-tools/raw/osm/mapnik2mapcss/osm-results/mapnik.zip |
| 12 | | https://raw.github.com/molysgaard/OAM-JOSM/master/oam-style.mapcss |
| 13 | | }}} |
| 14 | | {{{ |
| 15 | | #!comment |
| 16 | | Note for translators: |
| 17 | | - The above list and this note can be stripped from translation. |
| 18 | | - The reference below to change the source of this page should be modified, so it tells the reader to modify the English page. |
| 19 | | }}} |
| 20 | | [[TranslatedPages]] |
| | 4 | = JOSM Map Styles = |
| | 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. |
| | 19 | Note that, unless you are working with add-on styles, likely you want to have only one style ☑ checked at a time. |
| | 20 | |
| | 21 | === Activating more styles === |
| | 22 | ''Instructions:'' |
| | 23 | |
| | 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 |
| | 31 | |
| | 32 | ''Example:'' Let's assume that you want to add [osmwiki:Key:maxspeed maxspeed=*] tags to OSM, then you probably will make use of the style [wikitr:/Styles/Maxspeed Maxspeed] (which displays the value of maxspeed on roads with different colors). The screencast/animation on the right side (click to enlarge) shows how to add this style to your list of "active styles". |
| | 33 | |
| | 34 | ==== Adding own styles ==== |
| | 35 | You can add own styles (from any URL/file) to the list of active styles – for example a style file which you have [#CreateStyle created yourself]. Just click the [[JOSMImage(dialogs/add)]] plus sign on the right and enter either path and filename or URL of your style file. |
| | 36 | |
| | 37 | |
| | 38 | == Available styles list == |
| 46 | | JOSM supports two formats to define a style: |
| 47 | | |
| 48 | | JOSM XML:: |
| 49 | | The traditional style format in JOSM. The [http://josm.openstreetmap.de/svn/trunk/styles/standard/elemstyles.xml standard style] contains some documentation. |
| 50 | | MapCSS:: |
| 51 | | Style language similar to [http://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS] originally developed for Potlatch 2, but aims to be a standard for map styles. (since r3902) |
| 52 | | * General information can be found in the [http://wiki.openstreetmap.org/wiki/Category:MapCSS osm wiki]. |
| 53 | | * A [[Help/Styles/MapCSSTutorial|Short tutorial]] should get you started. |
| 54 | | * The [[Help/Styles/MapCSSImplementation|JOSM implementation reference]] lists the supported features in more detail. |
| 55 | | |
| 56 | | Style files with different formats are compatible, they can be loaded at the same time. |
| | 48 | JOSM supports styles in the MapCSS format. It is a style language similar to [https://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS] originally developed for Potlatch 2. |
| | 49 | * General information can be found in the [osmwiki:Category:MapCSS osm wiki]. |
| | 50 | * A [wikitr:/Help/Styles/MapCSSTutorial Short tutorial] should get you started. |
| | 51 | * The [wikitr:/Help/Styles/MapCSSImplementation JOSM implementation reference] lists the supported features in more detail. |
| | 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. |
| 68 | | * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory). |
| 69 | | * Use a path relative to your local style file. |
| 70 | | * New icons can be directly referenced using a http-link. These are downloaded and cached internally. |
| 71 | | * Since JOSM version 2289 Zip-Files are supported. |
| 72 | | * The zip file must contain at least one file with extension xml. |
| 73 | | * Icon names and path are relative to the topmost zip directory. |
| 74 | | * If there are multiple XML files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive). |
| 75 | | * When the JOSM wiki is used for designing of new styles you have some additional options: |
| 76 | | * Each file attached to the wiki page is automatically included in the Zip downloaded by JOSM. |
| 77 | | * If you don't want a file in the Zip file, add the text '''(NOZIP)''' in the description of the attachment. |
| 78 | | * If you add a Zip file and want its contents included, you may add '''(EXTRACT)''' in the description of the attachment. |
| 79 | | * The server automatically switches from download of single file to Zip download when files are attached. |
| | 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). |
| | 91 | * Icon names and path are relative to the topmost zip directory. |
| | 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: |
| | 98 | * Each file attached to the wiki page is automatically included in the zip file downloaded by JOSM. |
| | 99 | * If you don't want a file in the zip file, add the text **(NOZIP)** in the description of the attachment. |
| | 100 | * If you add a zip file and want its contents included, you may add **(EXTRACT)** in the description of the attachment. |
| | 101 | * Empty image paths are not allowed. |
| | 102 | |
| | 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 |
| 111 | | You can use the following hidden preferences: |
| 112 | | * mappaint.fillalpha |
| 113 | | * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50. |
| 114 | | * mappaint.fillareas (show areas) |
| 115 | | * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered |
| 116 | | * 0 - areas will be surrounded by lines only and name will not be rendered |
| 117 | | * any other number - areas will be filled with their corresponding colour and name will be rendered at any zoom level below the given number in meters |
| 118 | | * mappaint.showicons |
| 119 | | * select whether icons are shown - same values as mappaint.fillareas |
| 120 | | * mappaint.shownames |
| 121 | | * select whether names are shown - same values as mappaint.fillareas |
| 122 | | * mappaint.strokes |
| 123 | | * select whether strokes or full lines are used - same values as mappaint.fillareas |
| 124 | | * mappaint.useRealWidth |
| 125 | | * true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file |
| 126 | | * false (default) - ways will have the same width on every zoom level |
| 127 | | * mappaint.zoomLevelDisplay |
| 128 | | * true - elements visibility depends on zoom level |
| 129 | | * false (default) - all elements are displayed |
| 130 | | * mappaint.fontsize |
| 131 | | * 8 - size of mappaint texts |
| | 156 | == Advanced Preferences ==#AdvancedPreferences |
| | 157 | Some styles may have options. They are available via a right click (context menu) on the style's entry inside the [wikitr:/Help/Dialog/MapPaint map paint style dialog] window. E.g. JOSM's current default map style (MapCSS) has the option to display nodes at low zoom levels "less obtrusive" (enabled by default). |
| | 158 | |
| | 159 | In addition, you can use the following hidden preferences: |
| | 160 | * `mappaint.fillalpha` |
| | 161 | * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50. |
| | 162 | * `mappaint.fillareas` (show areas) |
| | 163 | * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered |
| | 164 | * 0 - areas will be surrounded by lines only and name will not be rendered |
| | 165 | * any other number - areas will be filled with their corresponding colour and name will be rendered at any zoom level below the given number in meters |
| | 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` |
| | 176 | * true - elements visibility depends on zoom level |
| | 177 | * false (default) - all elements are displayed |
| | 178 | * `mappaint.fontsize` |
| | 179 | * size of mappaint texts (default=8) |
| | 180 | |
| | 181 | ---- |
| | 182 | Back to [wikitr:/Help Main Help] |
