Changes between Version 84 and Version 174 of Styles


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

Legend:

Unmodified
Added
Removed
Modified

  • Styles

    v84 v174  
    1 {{{
    2 #!comment
    3 This contains the list of external style addresses.
    4 It will be parsed about each 10 minutes and is used to update the styles list.
    5 
    6 http://maps.tilusnet.com/josmdata/elemstyles_nolabels.xml
    7 http://download.freemap.sk/JOSM/conscriptionnumbers.mapcss
    8 http://www.freietonne.de/ft_icons/josm/FreieTonne_rules_presets_zip.php
    9 http://github.com/avar/osmis-josm-style/raw/master/elemstyles_is.xml
    10 http://dev.openseamap.org/josm/seamark_styles.xml
    11 http://dev.openseamap.org/josm/sport_styles.mapcss
    12 http://osmalba.org/josm_styles/naptan_bus_stops.zip
    13 http://github.com/bastik/mapcss-tools/raw/osm/mapnik2mapcss/osm-results/mapnik.zip
    14 https://raw.github.com/molysgaard/OAM-JOSM/master/oam-style.mapcss
    15 https://github.com/simon04/coloured-addresses.mapcss/raw/master/dist/coloured-addresses.mapcss
    16 https://dl.dropbox.com/u/8010189/Forum%20attachments/Hide_nodes.mapcss
    17 https://raw.github.com/gist/1277481/railway.mapcss
    18 http://ubuntuone.com/252trPHQ7upvvFXtcAXLF5
    19 }}}
    20 {{{
    21 #!comment
    22 Note for translators:
    23  - The above list and this note can be stripped from translation.
    24  - The reference below to change the source of this page should be modified, so it tells the reader to modify the English page.
    25 }}}
    261[[TranslatedPages]]
     2[[PageOutline(2-10,Table of Content)]]
    273
    284= JOSM Map Styles =
    29 [[Image(source:trunk/images/dialogs/mapstyle.png)]]
    30 The JOSM map display can be customized with different 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.
    316
    32 == Choose Styles ==
     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.
    338
    34 JOSM offers a preselection of styles, that can be turned on or off in the [[Help/Dialog/MapPaint|map style dialog]]. There are base styles (e.g. [source:trunk/styles/standard/elemstyles.xml 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:
     9Further customization is possible via [#AdvancedPreferences style options] or by [#CreateStyle creating your own style].
    3510
     11== Choose styles ==#ChooseStyles
     12JOSM 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).
     13
     14JOSM 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
     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)
     18
     19Note 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
     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=)]]
     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]
     281. Choose a style in the list of ''Available styles'' (left side)
     291. Activate it by clicking the [[JOSMImage(preferences/activate-right)]] blue right arrow button between the lists.
     301. 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 ====
     35You 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 ==
    3639[[Styles(en|styles|short description|author|description|version|More details)]]
    3740
    38 To add more styles to your list, open the map style preferences by clicking the [[Image(source:trunk/images/dialogs/mappaintpreference.png)]] [[Help/Dialog/MapPaint#MapStyleSettings|Settings]] button in the map style dialog.
    39 
    40 ''(Alternatively you can navigate directly to the [Help/Preferences/Map#MapPaintStyles Map Paint Styles Preferences]: Edit -> Preferences -> [[Image(source:trunk/images/preferences/map.png,15)]] Map Settings (3rd button on the left) -> Map Paint Styles (2nd tab))''
    41 
    42 ''Example'':
    43  Let's assume that you're interested in sea maps, then you probably will make use of the style "SeaMap FreieTonne": Just highlight this entry in the "Available Styles" list by clicking on it and press the [[Image(source:trunk/images/preferences/activate-right.png)]] blue right arrow button in the center. Now it should be one of your "Active Styles". Well, let's continue with advanced style usage! You created your own style ([#CreateStyle see below])? 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.
    4441
    4542== Create your own style ==#CreateStyle
    46 
    4743You don't like the standard style? Change it to your own liking:
    4844
    49  * In the [[Help/Dialog/MapPaint|map 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.
    50  * Or create a style from scratch and add it in the JOSM mappaint preferences.
     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.
     46* Or create a style from scratch and add it in the JOSM mappaint preferences.
    5147
    52 JOSM supports two formats to define a style:
    53 
    54  JOSM XML::
    55   The traditional style format in JOSM. The [source:trunk/styles/standard/elemstyles.xml standard style] contains some documentation.
    56  MapCSS::
    57   Style language similar to [https://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS] originally developed for Potlatch 2, but aims to be a standard for map styles. (since r3902)
    58   * General information can be found in the [http://wiki.openstreetmap.org/wiki/Category:MapCSS osm wiki].
    59   * A [[Help/Styles/MapCSSTutorial|Short tutorial]] should get you started.
    60   * The [[Help/Styles/MapCSSImplementation|JOSM implementation reference]] lists the supported features in more detail.
    61 
    62 Style files with different formats are compatible, they can be loaded at the same time.
     48JOSM 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.
    6352
    6453== Make your style available to other users ==
     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.
     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.
    6575
    66  * Either edit this wiki page and add URLs for new style files to the list at the top.
    67  * Or create a wiki page similar to [[Styles/Maxspeed]] (XML) or [[Styles/Modified]] (MapCSS).
    68   * for automatical version adjustment you can use two internal variables ({{{"1.[[revision]]_[[date]]" --> 1.13_2011-02-24}}}):
    69    1. {{{[[revision]]}}} - is the latest version number of the wiki page
    70    1. {{{[[date]]}}} - is the date of the last edit
    71   * **Note**: Spam filter prohibits adding many external (icon) links. Please, if possible, attach icons to the wiki page ([#Iconhandling see below]). 
    72 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).
     76== Icons ==#Icons
     77`.png` and `.svg` files are supported. See [wikitr:/DevelopersGuide/DefaultPresets#NewIcons Defaultpresets New Icons] for details and problems with `.svg`
    7378
    74 == Icons
    75 .png and .svg files are supported.
     79=== Icon testing ===
     80Icons 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).
    81  * Use a path relative to your local style file.
    82  * New icons can be directly referenced using a http-link. These are downloaded and cached internally.
    83  * Since JOSM revision [/changeset/2289/josm 2289] zip files are supported.
    84   * The zip file must contain at least one file with extension xml (or mapcss).
    85   * Icon names and path are relative to the topmost zip directory.
    86   * If there are multiple XML files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive).
    87  * When the JOSM wiki is used for designing of new styles you have some additional options:
    88   * Each file attached to the wiki page is automatically included in the zip file downloaded by JOSM.
    89   * If you don't want a file in the zip file, add the text **(NOZIP)** in the description of the attachment.
    90   * If you add a zip file and want its contents included, you may add **(EXTRACT)** in the description of the attachment.
    91   * 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.
    92102
    93  
     103== Translation ==
     104Styles, 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.
     105To create these files there exist scripts in the SVN directory [source:osm/applications/editors/josm/i18n/ i18n].
     106See also [wikitr:/Translations#Software software translation section] in translation documentation.
     107
     108== Updating styles in JOSM ==
     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:
     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
     119or:
     120
     121* Remove the content of your [wikitr:/Help/Action/About#InstallationDetails <josm.cache>] folder
     122* Restart JOSM
     123
     124To 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
    94130
    95131== Styles managed in JOSM wiki ==
     132[[TitleIndexTr(Styles/)]]
    96133
    97 [[TitleIndex(Styles/)]]
    98134
    99135== Rendering ==
    100 
    101 Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM wireframe mode.
     136Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM Wireframe view.
    102137
    103138=== Nodes ===
    104 
    105 Most nodes that correspond to tags in the [https://wiki.openstreetmap.org/wiki/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`.
    106140
    107141There are some special icons for missing/incomplete things:
    108142
    109 [[Image(Mappaint_no_icon.png)]] missing icon[[br]]
    110 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.
    111145
    112 [[Image(Mappaint_deprecated.png)]] warning icon[[br]]
    113 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.
    114148
    115149=== Ways ===
    116 
    117150Most ways that correspond to tags in the map features page will get special color, thickness and line style (e.g. dashed lines for railways).
    118151
    119152=== Areas ===
    120 
    121153Areas are ways that form a sort of ring. Most areas that corresponds to tags in the map features page will be filled with a special color (the filling will be transparent to some degree).
    122154
    123 == Advanced Preferences ==
    124155
    125 You can use the following hidden preferences:
    126  * {{{mappaint.fillalpha}}}
    127   * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50.
    128  * {{{mappaint.fillareas}}} (show areas)
    129   * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered
    130   * 0 - areas will be surrounded by lines only and name will not be rendered
    131   * 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
    132  * {{{mappaint.showicons}}}
    133   * select whether icons are shown - same values as {{{mappaint.fillareas}}}
    134  * {{{mappaint.shownames}}}
    135   * select whether names are shown - same values as {{{mappaint.fillareas}}}
    136  * {{{mappaint.strokes}}}
    137   * select whether strokes or full lines are used - same values as {{{mappaint.fillareas}}}
    138  * {{{mappaint.useRealWidth}}}
    139   * true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file
    140   * false (default) - ways will have the same width on every zoom level
    141  * {{{mappaint.zoomLevelDisplay}}}
    142   * true - elements visibility depends on zoom level
    143   * false (default) - all elements are displayed
    144  * {{{mappaint.fontsize}}}
    145   * size of mappaint texts (default=8)
     156== Advanced Preferences ==#AdvancedPreferences
     157Some 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
     159In 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----
     182Back to [wikitr:/Help Main Help]