Changes between Version 13 and Version 14 of SharedTileCache


Ignore:
Timestamp:
2014-03-25T12:41:59+01:00 (12 years ago)
Author:
wavexx
Comment:

Add lists of corrections made so far. Prefix the "tiles/" directory with osm/ to limit namespace squatting.

Legend:

Unmodified
Added
Removed
Modified

  • SharedTileCache

    v13 v14  
    66 Author/s:: Yuri D'Elia
    77 Last revised:: 2014-03-23
     8
     9=== Minor revisions ===
     10
     11Lists of concerns addressed since the initial draft:
     12
     13- 2014-03-24: Name of the cache "ID"/directory restricted to 20 characters (Robert Norris, from Viking development)
     14- 2014-03-24: Spaces removed from Windows/OSX shared tile root (Don-vip, JOSM)
     15- 2014-03-25: Use an "OSM" prefix for the shared tile root to limit namespace squatting (Kevin Krammer, Marble)
    816
    917== Premise ==
    … …  
    1927=== Unix/Linux ===
    2028
    21 The cache directory root is located in the {{{$XDG_CACHE_HOME/tiles}}} (usually "~/.cache/tiles"). See the [http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] to locate this directory correctly.
     29The cache directory root is located in the {{{$XDG_CACHE_HOME/osm/tiles}}} (usually "~/.cache/osm/tiles"). See the [http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] to locate this directory correctly.
    2230
    2331=== Windows XP ===
    2432
    25 {{{%UserProfile%\Local Settings\Application Data\SharedTileCache\}}}
     33{{{%UserProfile%\Local Settings\Application Data\OSM\SharedTileCache\}}}
    2634
    2735=== Windows Vista, 7, 8 ===
    2836
    29 {{{%UserProfile%\AppData\Local\SharedTileCache\}}}
     37{{{%UserProfile%\AppData\Local\OSM\SharedTileCache\}}}
    3038
    3139=== Mac OS X ===
    3240
    33 {{{NSCachesDirectory/SharedTileCache}}} (usually "~/Library/Caches/SharedTileCache"). Use the NSPathUtilities to locate the cache directory using [https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Miscellaneous/Foundation_Constants/Reference/reference.html NSCachesDirectory].
     41{{{NSCachesDirectory/OSM/SharedTileCache}}} (usually "~/Library/Caches/OSM/SharedTileCache"). Use the NSPathUtilities to locate the cache directory using [https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Miscellaneous/Foundation_Constants/Reference/reference.html NSCachesDirectory].
    3442
    3543== Tile directory layout ==
    … …  
    4654
    4755{{{
    48 ~/.cache/tiles/
    49 ~/.cache/tiles/Mapnik/
    50 ~/.cache/tiles/Mapnik/cache.ini
    51 ~/.cache/tiles/Mapnik/14/8709/5792.png
    52 ~/.cache/tiles/Mapnik/14/8709/5793.png.ini
    53 ~/.cache/tiles/Bing/
    54 ~/.cache/tiles/Bing/cache.ini
     56~/.cache/osm/tiles/
     57~/.cache/osm/tiles/Mapnik/
     58~/.cache/osm/tiles/Mapnik/cache.ini
     59~/.cache/osm/tiles/Mapnik/14/8709/5792.png
     60~/.cache/osm/tiles/Mapnik/14/8709/5793.png.ini
     61~/.cache/osm/tiles/Bing/
     62~/.cache/osm/tiles/Bing/cache.ini
    5563...
    5664}}}
    … …  
    6068The "Cache properties" file defines data associated with the cache itself. The file is named "cache.ini" an is located at the root level of the cache:
    6169
    62 {{{~/.cache/tiles/Mapnik/cache.ini}}}
     70{{{~/.cache/osm/tiles/Mapnik/cache.ini}}}
    6371
    6472The file format is a simple text file, UTF-8 encoded, with each line containing a "key=value" pair. Applications '''must''' ignore any key that they don't know. Applications '''must''' also preserve all keys when the file is being updated. Any other arbitrary key can be included.