Changes between Version 87 and Version 88 of Styles


Ignore:
Timestamp:
2013-07-15T18:45:09+02:00 (13 years ago)
Author:
skyper
Comment:

added note about file extension for external URLs

Legend:

Unmodified
Added
Removed
Modified
  • Styles

    v87 v88  
    11{{{
    22#!comment
    3 This contains the list of external style addresses in alphabetical order.
     3This contains the list of external style addresses in alphabetical order. (Only addresses with file-extension are supported.)
    44It will be parsed about each 10 minutes and is used to update the styles list.
    55
     
    2727
    2828= JOSM Map Styles =
    29 [[Image(source:trunk/images/dialogs/mapstyle.png)]]
     29[[Image(source:trunk/images/dialogs/mapstyle.png,middle,margin-right=20)]]
    3030The JOSM map display can be customized with different styles.
    3131
     32
    3233== Choose Styles ==
    33 
    3434JOSM 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:
    3535
     
    4343 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.
    4444
     45
    4546== Create your own style ==#CreateStyle
    46 
    4747You don't like the standard style? Change it to your own liking:
    4848
    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.
     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.
    5151
    5252JOSM supports two formats to define a style:
    5353
    5454 JOSM XML::
    55   The traditional style format in JOSM. The [source:trunk/styles/standard/elemstyles.xml standard style] contains some documentation.
     55 The traditional style format in JOSM. The [source:trunk/styles/standard/elemstyles.xml standard style] contains some documentation.
    5656 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.
     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.
    6161
    6262Style files with different formats are compatible, they can be loaded at the same time.
    6363
    6464== Make your style available to other users ==
    65 
    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]). 
     65* Either edit this wiki page and add URLs for new style files to the list at the top.
     66 * **Note**: Only URLs with file-extension (e.g. *.mapcss, *.xml, *.zip, *.php) are supported.
     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]). 
    7272In 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).
    7373
     
    7878There are different forms to handle icons:
    7979
    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.
     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.
    9292
    93  
    9493
    9594== Styles managed in JOSM wiki ==
    96 
    9795[[TitleIndex(Styles/)]]
    9896
     97
    9998== Rendering ==
    100 
    10199Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM wireframe mode.
    102100
    103101=== Nodes ===
    104 
    105102Most 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}}}.
    106103
     
    114111
    115112=== Ways ===
    116 
    117113Most ways that correspond to tags in the map features page will get special color, thickness and line style (e.g. dashed lines for railways).
    118114
    119115=== Areas ===
    120 
    121116Areas 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).
    122117
     118
    123119== Advanced Preferences ==
     120You can use the following hidden preferences:
     121* {{{mappaint.fillalpha}}}
     122 * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50.
     123* {{{mappaint.fillareas}}} (show areas)
     124 * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered
     125 * 0 - areas will be surrounded by lines only and name will not be rendered
     126 * 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
     127* {{{mappaint.showicons}}}
     128 * select whether icons are shown - same values as {{{mappaint.fillareas}}}
     129* {{{mappaint.shownames}}}
     130 * select whether names are shown - same values as {{{mappaint.fillareas}}}
     131* {{{mappaint.strokes}}}
     132 * select whether strokes or full lines are used - same values as {{{mappaint.fillareas}}}
     133* {{{mappaint.useRealWidth}}}
     134 * true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file
     135 * false (default) - ways will have the same width on every zoom level
     136* {{{mappaint.zoomLevelDisplay}}}
     137 * true - elements visibility depends on zoom level
     138 * false (default) - all elements are displayed
     139* {{{mappaint.fontsize}}}
     140 * size of mappaint texts (default=8)
    124141
    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)
     142----
     143Back to [wiki:/Help main help]