Changes between Version 29 and Version 30 of Help/Preferences


Ignore:
Timestamp:
2020-05-07T15:55:21+02:00 (6 years ago)
Author:
skyper
Comment:

rework of links

Legend:

Unmodified
Added
Removed
Modified
  • Help/Preferences

    v29 v30  
    22
    33= Preferences Overview =
    4 
    54The preference data in JOSM is composed of a set of name->value pairs. The setting names are mostly ''namespaced'' with dot `.` separated words. Many JOSM plugins store their preferences grouped in a namespace.
    65
    7 You can get a similar raw view by viewing this file, but this [wikitr:/Help/Preferences/Advanced 'Advanced' preferences panel] is intended to provide an easier alternative.
     6You can get a similar raw view by viewing these files, but the preferences' panel [[JOSMImage(preferences/advanced,link=,24,middle)]] [wikitr:/Help/Preferences/Advanced advanced preferences] is intended to provide an easier alternative.
     7
    88
    99== Menus ==
     10Most of the settings can be reached via menus in the [[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences preferences dialog], See the individual panel pages:
     11[[TitleIndex(Help/Preferences/,hideprefix,exclude=*Advanced,format=compact)]]
    1012
    11 Most of the settings can be reached via menus
    12 * [wikitr:/Help/Action/Preferences]
    13 * [wikitr:/Help/Preferences/Advanced]
    1413
    1514== Other preferences ==
     15* [wikitr:"/Help/JOSM interface customization" JOSM interface customization]
    1616
    17 * [wikitr:/Help/JOSM interface customization]
    1817
    1918== JOSM preference/data/cache directories ==#JOSMpreferencedatacachedirectories
     
    3029
    3130=== Windows ===
    32 
    33 '''Preferences''' and '''user data''' is stored in
     31**Preferences** and **user data** is stored in
    3432{{{
    3533%APPDATA%\JOSM
     
    3735To locate this folder, try opening Explorer window and paste the following text in location, then hit enter: `%APPDATA%\JOSM`, On Windows Vista and later, it should be something like `C:\Users\<YourName>\AppData\Roaming\JOSM`. Note, that the directory `C:\Users\<YourName>\AppData` can be hidden by default.
    3836
    39 The '''cache''' is located in
     37The **cache** is located in
    4038{{{
    4139%LOCALAPPDATA%\JOSM\cache
     
    4846
    4947=== MacOS===
    50 
    5148On MacOS, the default locations are as follows:
    5249 Preferences:: `Users/<YourName>/Library/Preferences/JOSM`
     
    5552
    5653=== Linux ===
    57 
    5854Since r11162, JOSM uses the [https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] for fresh installations, i.e.
    5955 Preferences:: `$HOME/.config/JOSM`
     
    7066JOSM will continue to use the old locations if the directory `$HOME/.josm` exists. If you have a fresh installation but prefer the old scheme, you can create the `$HOME/.josm` directory by hand.
    7167
    72 Note on hidden files: File names beginning with a dot are hidden on Linux. To show the contents of the hidden folder, use the file manager and enter "~/.josm" in the address line (if no address line is visible just try to enter a letter and hopefully a popup to enter the address will open). Alternatively, it is possible to "show hidden" files and folders in the file manager, using the keyboard shortcut Ctrl+H.
     68Note on hidden files: File names beginning with a dot are hidden on Linux. To show the contents of the hidden folder, use the file manager and enter `~/.josm` in the address line (if no address line is visible just try to enter a letter and hopefully a popup to enter the address will open). Alternatively, it is possible to "show hidden" files and folders in the file manager, using the keyboard shortcut `Ctrl+H`.
    7369
    7470=== Customization (all operating systems) ===
    75 
    7671==== Setting all 3 locations ====
    77 
    78 The locations can be set using system properties specified from the [wikitr:/Help/CommandLineOptions|commandline]:
     72The locations can be set using system properties specified from the [wikitr:/Help/CommandLineOptions command line]:
    7973 Preferences:: `-Djosm.pref=...`
    8074 User data:: `-Djosm.userdata=...`
     
    8781
    8882==== Setting a common directory ====
    89 
    9083Alternatively, all 3 locations can be moved to a common location using the system property `-Djosm.home=...`.
    9184For example with
     
    9992
    10093==== Changing the directory base name ====
    101 
    10294Instead of specifying the full path for the JOSM directories, you can use the system property `-Djosm.dir.name=` to modify just the name of the last directory component, which is `JOSM` by default. This is especially useful in order to keep multiple ''profiles'' on one computer, which should not interfere. For example, to have one profile for productive work with the stable tested version and one for the experimental development version, you would start the development version like this:
    103 {{{
     95{{{#!sh
    10496java -Djosm.dir.name=JOSM-dev -jar josm-latest.jar
    10597}}}
     
    111103(For locations in the style prior to r11162, the lower-case version with the prepended dot will be used, e.g. `$HOME/.josm-dev`.)
    112104
     105
    113106=== preferences.xml Schema ===
     107See [/preferences-1.0.xml].
    114108
    115 http://josm.openstreetmap.de/preferences-1.0
    116 
    117 Some descriptions can be found in [wikitr:/Help/Preferences/ImportExport] (stub)
     109Some descriptions can be found in [wikitr:/Help/Preferences/ImportExport Custom configuration XML files for JOSM]
    118110
    119111=== Auto save subfolder ===
    120 
    121112Utilized by [wikitr:/Help/Action/AutoSave autosave function].
    122113
     114
    123115== See also ==
    124 * [wikitr:/Help/ResetPreferences] - ways to reset preferences
    125 * [wikitr:/Help/Action/AutoSave] feature
    126 * [wikitr:/Help/CommandLineOptions] - how to change/load custom settings via command line
     116* [wikitr:/Help/ResetPreferences Reset preferences] - ways to reset preferences
     117* [wikitr:/Help/Action/AutoSave Autosave] feature
     118* [wikitr:/Help/CommandLineOptions Command line options] - how to change/load custom settings via command line
     119
     120
     121----
     122Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
     123Back to [wikitr:/Help Main Help]