Changes between Version 131 and Version 171 of Styles
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Styles
v131 v171 1 1 [[TranslatedPages]] 2 2 [[PageOutline(2-10,Table of Content)]] 3 3 4 = JOSM Map Styles = 4 [[Image(source:trunk/images/dialogs/mapstyle.svg,middle,margin-right=20)]] 5 The JOSM [[Help/MapView|map display]] can be easily customized with different styles. Many styles are included with JOSM by default. 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 6 7 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.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 8 9 Further customization is possible via [ [#AdvancedPreferences|style options]] or by [[#CreateStyle|creating your own style]].9 Further customization is possible via [#AdvancedPreferences style options] or by [#CreateStyle creating your own style]. 10 10 11 11 == Choose styles ==#ChooseStyles 12 13 12 JOSM has ''three lists'' of ''map styles:'' available styles (all styles from the style repository) → active styles (your favourites) → ☑ chosen styles (actually used for the map painting). 14 13 15 14 JOSM comes with some styles being in the "active styles" list by default. You can choose styles from this list of "active styles" to be actually used for the map painting by clicking the check box (☑) at the desired style's line 16 * in the [ [Help/Dialog/MapPaint|map paint style dialog]] or17 * in the [ [Help/Menu/View|"View" menu]] ( → "Map paint styles") or18 * (less comfortable)in the Map Paint Styles Preferences (see section below)15 * in the [wikitr:/Help/Dialog/MapPaint map paint style dialog] or 16 * in the [wikitr:/Help/Menu/View "View" menu] ( → "Map paint styles") or 17 * in the Map Paint Styles Preferences (see section below) 19 18 20 19 Note that, unless you are working with add-on styles, likely you want to have only one style ☑ checked at a time. 21 20 22 21 === Activating more styles === 23 [[Image(addstyle.gif, right, 250px, title=animation of how to activate and choose an example style)]] 22 ''Instructions:'' 24 23 25 ''Instructions:'' 26 1. open the [Help/Preferences/Map#MapPaintStyles Map Paint Styles Preferences] by either 27 * clicking the [[Image(source:trunk/images/dialogs/mappaintpreference.png)]] [[Help/Dialog/MapPaint#MapStyleSettings|Settings]] button in the map style dialog (shown in the animation) or 28 * via [[Help/Menu/View|"View" menu]] → "Map paint styles" → "Map paint preferences" or 29 * (less comfortable) via the general preferences window ([[Help/Menu/Edit|Menu Edit]] → [[Help/Action/Preferences|Preferences]] → [[Image(source:trunk/images/preferences/map.png,15)]] [[Help/Preferences/Map|Map Settings]] (3rd button on the left) → Map Paint Styles (2nd tab)) 30 2. select a style in the list of "available styles" (left side) 31 3. activate it by clicking the [[Image(source:trunk/images/preferences/activate-right.png)]] blue right arrow button (in the centre) 32 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 33 31 34 ''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 [wiki :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".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". 35 33 36 34 ==== Adding own styles ==== 37 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 [[Image(source:trunk/images/dialogs/add.png)]] plus sign on the right and enter either path and filename or URL of your style file. 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 38 37 39 38 == Available styles list == 39 [[Styles(en|styles|short description|author|description|version|More details)]] 40 40 41 [[Styles(en|styles|short description|author|description|version|More details)]]42 41 43 42 == Create your own style ==#CreateStyle 44 43 You don't like the standard style? Change it to your own liking: 45 44 46 * In the [ [Help/Dialog/MapPaint|map paint style dialog]], right click one of the styles and select [[Image(source:/trunk/images/copy.png)]]"save as...". A copy will be added to the list of styles. You can open the file in a text editor and reload after doing some changes.45 * In the [wikitr:/Help/Dialog/MapPaint map paint style dialog], right click one of the styles and select [[JOSMImage(copy,middle,24,link=)]] "save as...". A copy will be added to the list of styles. You can open the file in a text editor and reload after doing some changes. 47 46 * Or create a style from scratch and add it in the JOSM mappaint preferences. 48 47 49 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. 50 49 * General information can be found in the [osmwiki:Category:MapCSS osm wiki]. 51 * A [ [Help/Styles/MapCSSTutorial|Short tutorial]] should get you started.52 * The [ [Help/Styles/MapCSSImplementation|JOSM implementation reference]] lists the supported features in more detail.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. 53 52 54 53 == Make your style available to other users == 55 * Either create a wiki page similar to [[Styles/Modified]]. 56 * don't forget to enclose your mappaint code by a code block (`#!style type="mapcss"` needs to be on a new line after `{{{`): 57 * `{{{` 58 * `#!style type="mapcss"` 59 * ... 60 * `}}}` 61 * for automatic version adjustment you should use two internal variables: 62 * {{{[[revision]]}}} - is the latest version number of the wiki page 63 * {{{[[date]]}}} - is the date of the last edit 64 * e.g. {{{"1.[[revision]]_[[date]]"}}} converts to e.g. {{{1.13_2014-02-24}}} 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 1. `{{{` 60 1. `#!style type="mapcss"` 61 1. ... 62 1. `}}}` 63 1. for automatic version adjustment you have to use `[[revision]]_[[date]]` in your version variable: 64 * `[[revision]]` - is the latest version number of the wiki page 65 * `[[date]]` - is the date of the last edit of the wiki page 66 * recommended usage: `version="1.[[revision]]_[[date]]"` (converts to e.g. `1.13_2019-02-24`) 67 * this is required for an automatic update within JOSM 65 68 * **Note**: Spam filter prohibits adding many external (icon) links. Please, if possible, attach icons to the wiki page ([#Iconhandling see below]). … 66 * '''or''' edit the page StylesSource and add URLs for new style files to the list at the top. 69 * '''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.) 67 70 * **Note**: Only URLs with file-extension (e.g. *.mapcss, *.zip, *.php) are supported. 68 71 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). 69 72 70 == Icons 71 .png and .svg files are supported. 73 == Icons ==#Icons 74 `.png` and `.svg` files are supported. See [wikitr:/DevelopersGuide/DefaultPresets#NewIcons Defaultpresets New Icons] for details and problems with `.svg` 72 75 73 === Icon handling === 76 === Icon testing === 77 Icons can be tested with the [wikitr:/Styles/IconTester icon tester]. 78 79 === Icon handling === #Iconhandling 74 80 There are different forms to handle icons: 75 81 76 * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory). 77 * Use a path relative to your local style file. 78 * New icons can be directly referenced using a http-link. These are downloaded and cached internally. 79 * Since JOSM revision [/changeset/2289/josm 2289] zip files are supported. 80 * The zip file must contain at least one file with extension mapcss. 82 * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's [source:/trunk/resources/images internal image directory]). 83 * Use a path relative to your local style file. (This works only for Styles, not for Presets.) 84 * 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].) 85 * New icons can be directly referenced using a https- or http-link. These are downloaded and cached internally. 86 * zip files are supported too. 87 * The zip file must contain at least one file with extension mapcss (for styles) or xml (for presets). 81 88 * Icon names and path are relative to the topmost zip directory. 82 89 * If there are multiple files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive). 83 * Since JOSM revision [/changeset/4713/josm 4713] inline encoding as described in [[http://tools.ietf.org/html/rfc2397|RFC 2397]] is supported.84 * Example for PNG: {{{data:image/png;base64,...databytes...}}}85 * Example for SVG: {{{data:image/svg+xml;base64,...databytes...}}}86 * [wiki :Help/Base64 More information] about {{{data:image/...}}}in JOSM.87 * When the JOSM wiki is used for designing of new styles you have some additional options:90 * Inline encoding as described in [https://tools.ietf.org/html/rfc2397 RFC 2397] is supported too. 91 * Example for PNG: `data:image/png;base64,...databytes...` 92 * Example for SVG: `data:image/svg+xml;base64,...databytes...` 93 * [wikitr:/Help/Base64 More information] about `data:image/...` in JOSM. 94 * When the JOSM wiki is used for designing of new styles or presets you have some additional options: 88 95 * Each file attached to the wiki page is automatically included in the zip file downloaded by JOSM. 89 96 * If you don't want a file in the zip file, add the text **(NOZIP)** in the description of the attachment. 90 97 * If you add a zip file and want its contents included, you may add **(EXTRACT)** in the description of the attachment. 98 * Empty image paths are not allowed. 91 99 100 == Translation == 101 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. 102 To create these files there exist scripts in the SVN directory [source:osm/applications/editors/josm/i18n/ i18n]. 103 See also [wikitr:/Translations#Software software translation section] in translation documentation. 104 105 == Updating styles in JOSM == 106 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: 107 * Open the [wikitr:/Help/Action/Preferences Preferences] 108 * Make sure [wikitr:/Help/ExpertMode Expert mode] is enabled 109 * Open the [wikitr:/Help/Preferences/Advanced Advanced Preferences] 110 * Search for keys starting with: `mirror.https://josm.openstreetmap.de/josmfile?page_Styles/` (or `mirror.` for other external sources) 111 * Select the style you want to update 112 * Click on Reset at the bottom of the window 113 * Click on OK to save the changes (and to close the preference window) 114 * Restart JOSM 115 116 or: 117 118 * Remove the content of your [wikitr:/Help/Action/About#InstallationDetails <josm.cache>] folder 119 * Restart JOSM 120 121 To check the version of the style in JOSM do the following steps 122 * Open the [wikitr:/Help/Dialog/MapPaint Map Paint Styles Dialog] 123 * Right click on a style 124 * Choose Info 125 * Click on Source Tab 126 * Search for `version:` at the beginning of the source code 92 127 93 128 == Styles managed in JOSM wiki == … … 96 131 97 132 == Rendering == 98 Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM wireframe mode.133 Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM Wireframe view. 99 134 100 135 === Nodes === 101 Most nodes that correspond to tags in the [osmwiki:Map_Features Map Features] page will show an appropriate icon, e.g. a white "P" on blue ground for {{{amenity=parking}}}.136 Most nodes that correspond to tags in the [osmwiki:Map_Features Map Features] page will show an appropriate icon, e.g. a white "P" on blue ground for `amenity=parking`. 102 137 103 138 There are some special icons for missing/incomplete things: 104 139 105 [[Image(Mappaint_no_icon.png )]] missing icon[[br]]106 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.140 [[Image(Mappaint_no_icon.png,margin-right=5,link=)]] missing icon \\ 141 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. 107 142 108 [[Image(Mappaint_deprecated.png )]] warning icon[[br]]109 The corresponding tag was once used but is no longer recommended to be used - or - it is not suitable for a node, e.g. {{{highway=motorway}}}just doesn't make sense on a node. Probably not all deprecated tags will show this icon.143 [[Image(Mappaint_deprecated.png,margin-right=5,link=)]] warning icon \\ 144 The corresponding tag was once used but is no longer recommended to be used - or - it is not suitable for a node, e.g. `highway=motorway` just doesn't make sense on a node. Probably not all deprecated tags will show this icon. 110 145 111 146 === Ways === … … 116 151 117 152 118 == Advanced Preferences == 119 Some styles may have options. They are available via a right click (context menu) on the style's entry inside the [ [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).153 == Advanced Preferences ==#AdvancedPreferences 154 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). 120 155 121 156 In addition, you can use the following hidden preferences: 122 * {{{mappaint.fillalpha}}}157 * `mappaint.fillalpha` 123 158 * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50. 124 * {{{mappaint.fillareas}}}(show areas)159 * `mappaint.fillareas` (show areas) 125 160 * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered 126 161 * 0 - areas will be surrounded by lines only and name will not be rendered 127 162 * 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 128 * {{{mappaint.showicons}}}129 * select whether icons are shown - same values as {{{mappaint.fillareas}}}130 * {{{mappaint.shownames}}}131 * select whether names are shown - same values as {{{mappaint.fillareas}}}132 * {{{mappaint.strokes}}}133 * select whether strokes or full lines are used - same values as {{{mappaint.fillareas}}}134 * ~~ {{{mappaint.useRealWidth}}}~~163 * `mappaint.showicons` 164 * select whether icons are shown - same values as `mappaint.fillareas` 165 * `mappaint.shownames` 166 * select whether names are shown - same values as `mappaint.fillareas` 167 * `mappaint.strokes` 168 * select whether strokes or full lines are used - same values as `mappaint.fillareas` 169 * ~~`mappaint.useRealWidth`~~ 135 170 * ~~true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file~~ 136 171 * ~~false (default) - ways will have the same width on every zoom level~~ 137 * {{{mappaint.zoomLevelDisplay}}}172 * `mappaint.zoomLevelDisplay` 138 173 * true - elements visibility depends on zoom level 139 174 * false (default) - all elements are displayed 140 * {{{mappaint.fontsize}}}175 * `mappaint.fontsize` 141 176 * size of mappaint texts (default=8) 142 177 143 178 ---- 144 Back to [wiki :/Help main help]179 Back to [wikitr:/Help Main Help]