Changes between Version 160 and Version 174 of Styles


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

Legend:

Unmodified
Added
Removed
Modified

  • Styles

    v160 v174  
    33
    44= JOSM Map Styles =
    5 [[JOSMImage(dialogs/mapstyle,middle,margin-right=20,48)]] The JOSM [wikitr:/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.
    66
    7 There are ''base styles'' (e.g. [source:/trunk/resources/styles/standard/elemstyles.mapcss JOSM standard] or [source:/trunk/resources/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.
     7There 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.
    88
    99Further customization is possible via [#AdvancedPreferences style options] or by [#CreateStyle creating your own style].
    1010
    1111== Choose styles ==#ChooseStyles
    12 
    1312JOSM 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).
    1413
    … …  
    2120
    2221=== Activating more styles ===
    23 
    2422''Instructions:''
    2523
    26 1. Open the [wikitr:/Help/Preferences/Map#MapPaintStyles Map Paint preferences]
    27  * 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)]]
     241. 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=)]]
    2826 * via [wikitr:/Help/Menu/View View menu] → ''Map paint styles'' → ''Map paint preferences'' or
    29  * via the general preferences dialog [wikitr:/Help/Menu/Edit Menu Edit] → [wikitr:/Help/Action/Preferences Preferences] → [[JOSMImage(preferences/map,20,middle)]] [wikitr:/Help/Preferences/Map Map Settings] (3rd button on the left) → Map Paint Styles (2nd tab))
     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]
    30281. Choose a style in the list of ''Available styles'' (left side)
    31291. Activate it by clicking the [[JOSMImage(preferences/activate-right)]] blue right arrow button between the lists.
    … …  
    3735You 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.
    3836
     37
    3938== Available styles list ==
     39[[Styles(en|styles|short description|author|description|version|More details)]]
    4040
    41 [[Styles(en|styles|short description|author|description|version|More details)]]
    4241
    4342== Create your own style ==#CreateStyle
    4443You don't like the standard style? Change it to your own liking:
    4544
    46 * In the [wikitr:/Help/Dialog/MapPaint map paint style dialog], right click one of the styles and select [[JOSMImage(copy,middle,20)]] "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.
    4746* Or create a style from scratch and add it in the JOSM mappaint preferences.
    4847
    … …  
    5453== Make your style available to other users ==
    5554* Either create a wiki page similar to [wiki: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 have to use `[[revision]]_[[date]]` in your version variable:
    62   * {{{[[revision]]}}} - is the latest version number of the wiki page
    63   * {{{[[date]]}}} - is the date of the last edit of the wiki page
    64   * recommended usage: {{{version="1.[[revision]]_[[date]]"}}} (converts to e.g. {{{1.13_2019-02-24}}})
     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`)
    6569  * this is required for an automatic update within JOSM
    6670 * **Note**: Spam filter prohibits adding many external (icon) links. Please, if possible, attach icons to the wiki page ([#Iconhandling see below]). …
    6771* '''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.)
    6872 * **Note**: Only URLs with file-extension (e.g. *.mapcss, *.zip, *.php) are supported.
    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).
     73In 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.
    7075
    71 == Icons
     76== Icons ==#Icons
    7277`.png` and `.svg` files are supported. See [wikitr:/DevelopersGuide/DefaultPresets#NewIcons Defaultpresets New Icons] for details and problems with `.svg`
    7378
    … …  
    7580Icons can be tested with the [wikitr:/Styles/IconTester icon tester].
    7681
    77 === Icon handling ===
     82=== Icon handling === #Iconhandling
    7883There are different forms to handle icons:
    7984
    80 * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory).
     85* Icons distributed with JOSM can be entered directly with the path (relative to JOSM's [source:/trunk/resources/images internal image directory]).
    8186* Use a path relative to your local style file. (This works only for Styles, not for Presets.)
    82 * Use a path relative to a directory specified at the bottom in the [wikitr:/Help/Preferences/Map#MapPaintStyles Styles preferences page] or [wikitr:/Help/Preferences/Map#TaggingPresets Presets preferences page].)
    83 * New icons can be directly referenced using a http-link. These are downloaded and cached internally.
     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.
    8489* zip files are supported too.
    8590 * The zip file must contain at least one file with extension mapcss (for styles) or xml (for presets).
    8691 * Icon names and path are relative to the topmost zip directory.
    8792 * If there are multiple files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive).
    88 * Inline encoding as described in [[http://tools.ietf.org/html/rfc2397|RFC 2397]] is supported too.
    89  * Example for PNG: {{{data:image/png;base64,...databytes...}}}
    90  * Example for SVG: {{{data:image/svg+xml;base64,...databytes...}}}
    91  * [wikitr:/Help/Base64 More information] about {{{data:image/...}}} in JOSM.
    92 * When the JOSM wiki is used for designing of new styles you have some additional options:
     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:
    9398 * Each file attached to the wiki page is automatically included in the zip file downloaded by JOSM.
    9499 * If you don't want a file in the zip file, add the text **(NOZIP)** in the description of the attachment.
    95100 * 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.
    96102
    97103== Translation ==
    98104Styles, 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.
    99 To create these files there exist scripts in the SVN directory [osm:source:applications/editors/josm/i18n/ i18n].
     105To create these files there exist scripts in the SVN directory [source:osm/applications/editors/josm/i18n/ i18n].
    100106See also [wikitr:/Translations#Software software translation section] in translation documentation.
    101107
    102108== Updating styles in JOSM ==
    103 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. To immediately force an update you can do the following steps:
     109Once 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:
    104110* Open the [wikitr:/Help/Action/Preferences Preferences]
    105111* Make sure [wikitr:/Help/ExpertMode Expert mode] is enabled
    … …  
    124130
    125131== Styles managed in JOSM wiki ==
    126 [[TitleIndex(Styles/)]]
     132[[TitleIndexTr(Styles/)]]
    127133
    128134
    … …  
    131137
    132138=== Nodes ===
    133 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}}}.
     139Most 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`.
    134140
    135141There are some special icons for missing/incomplete things:
    136142
    137 [[Image(Mappaint_no_icon.png,margin-right=5)]] missing icon[[br]]
    138 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 \\
     144We 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.
    139145
    140 [[Image(Mappaint_deprecated.png,margin-right=5)]] warning icon[[br]]
    141 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.
     146[[Image(Mappaint_deprecated.png,margin-right=5,link=)]] warning icon \\
     147The 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.
    142148
    143149=== Ways ===
    … …  
    152158
    153159In addition, you can use the following hidden preferences:
    154 * {{{mappaint.fillalpha}}}
     160* `mappaint.fillalpha`
    155161 * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50.
    156 * {{{mappaint.fillareas}}} (show areas)
     162* `mappaint.fillareas` (show areas)
    157163 * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered
    158164 * 0 - areas will be surrounded by lines only and name will not be rendered
    159165 * 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
    160 * {{{mappaint.showicons}}}
    161  * select whether icons are shown - same values as {{{mappaint.fillareas}}}
    162 * {{{mappaint.shownames}}}
    163  * select whether names are shown - same values as {{{mappaint.fillareas}}}
    164 * {{{mappaint.strokes}}}
    165  * select whether strokes or full lines are used - same values as {{{mappaint.fillareas}}}
    166 * ~~{{{mappaint.useRealWidth}}}~~
     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`~~
    167173 * ~~true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file~~
    168174 * ~~false (default) - ways will have the same width on every zoom level~~
    169 * {{{mappaint.zoomLevelDisplay}}}
     175* `mappaint.zoomLevelDisplay`
    170176 * true - elements visibility depends on zoom level
    171177 * false (default) - all elements are displayed
    172 * {{{mappaint.fontsize}}}
     178* `mappaint.fontsize`
    173179 * size of mappaint texts (default=8)
    174180
    175181----
    176 Back to [wikitr:/Help Main help]
     182Back to [wikitr:/Help Main Help]