Changes between Version 29 and Version 36 of Help/Preferences


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences

    v29 v36  
    11[[TranslatedPages]]
     2[[PageOutline(2-10,Table of Contents)]]
    23
    34= Preferences Overview =
    4 
    55The 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.
    66
    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.
     7You 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.
    88
    9 == Menus ==
    10 
    11 Most of the settings can be reached via menus
    12 * [wikitr:/Help/Action/Preferences]
    13 * [wikitr:/Help/Preferences/Advanced]
     9Most of the settings can be reached via menus in the [[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences preferences dialog].
    1410
    1511== Other preferences ==
     12* [wikitr:"/Help/JOSM interface customization" JOSM interface customization]
    1613
    17 * [wikitr:/Help/JOSM interface customization]
    1814
    1915== JOSM preference/data/cache directories ==#JOSMpreferencedatacachedirectories
    … …  
    2723 Cache:: Files downloaded from the internet and stored for a limited time to avoid repeated downloads and allow faster access. For example imagery tiles and startup news.
    2824
    29 The default location of the directories depends on your operating system.
     25The default location of the directories depends on your operating system and is listed in the [wikitr:/Help/Action/About#InstallationDetails Installation details] tab of the [[JOSMImage(logo_48x48x32,link=,middle,24)]][wikitr:/Help/Action/About About dialog] in the [wikitr:/Help/Menu/Help Help menu]
    3026
    3127=== Windows ===
    32 
    33 '''Preferences''' and '''user data''' is stored in
     28**Preferences** and **user data** is stored in
    3429{{{
    3530%APPDATA%\JOSM
    … …  
    3732To 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.
    3833
    39 The '''cache''' is located in
     34The **cache** is located in
    4035{{{
    4136%LOCALAPPDATA%\JOSM\cache
    … …  
    4843
    4944=== MacOS===
    50 
    5145On MacOS, the default locations are as follows:
    5246 Preferences:: `Users/<YourName>/Library/Preferences/JOSM`
    … …  
    5549
    5650=== Linux ===
    57 
    5851Since r11162, JOSM uses the [https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] for fresh installations, i.e.
    5952 Preferences:: `$HOME/.config/JOSM`
    … …  
    6861 Cache:: `$HOME/.josm/cache`
    6962
     63If JOSM is installed via flatpak, the locations are
     64 Preferences:: `$HOME/.var/app/org.openstreetmap.josm/config`
     65 User data:: `$HOME/.var/app/org.openstreetmap.josm/data`
     66 Cache:: `$HOME/.var/app/org.openstreetmap.josm/cache`
     67
     68
    7069JOSM 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.
    7170
    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.
     71Note 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`.
    7372
    74 === Customization (all operating systems) ===
    75 
     73=== Customization (all operating systems) === #Customizationalloperatingsystems
    7674==== Setting all 3 locations ====
    77 
    78 The locations can be set using system properties specified from the [wikitr:/Help/CommandLineOptions|commandline]:
     75The locations can be set using system properties specified from the [wikitr:/Help/CommandLineOptions command line]:
    7976 Preferences:: `-Djosm.pref=...`
    8077 User data:: `-Djosm.userdata=...`
    … …  
    8784
    8885==== Setting a common directory ====
    89 
    9086Alternatively, all 3 locations can be moved to a common location using the system property `-Djosm.home=...`.
    9187For example with
    … …  
    9995
    10096==== Changing the directory base name ====
    101 
    10297Instead 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 {{{
     98{{{#!sh
    10499java -Djosm.dir.name=JOSM-dev -jar josm-latest.jar
    105100}}}
    … …  
    111106(For locations in the style prior to r11162, the lower-case version with the prepended dot will be used, e.g. `$HOME/.josm-dev`.)
    112107
     108
    113109=== preferences.xml Schema ===
     110See [/preferences-1.0.xml].
    114111
    115 http://josm.openstreetmap.de/preferences-1.0
    116 
    117 Some descriptions can be found in [wikitr:/Help/Preferences/ImportExport] (stub)
     112Some descriptions can be found in [wikitr:/Help/Preferences/ImportExport Custom configuration XML files for JOSM]
    118113
    119114=== Auto save subfolder ===
    120 
    121115Utilized by [wikitr:/Help/Action/AutoSave autosave function].
    122116
     117
    123118== 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
     119* [wikitr:/Help/Action/About#InstallationDetails Installation details]
     120* [wikitr:/Help/ResetPreferences Reset preferences] - ways to reset preferences
     121* [wikitr:/Help/Action/AutoSave Autosave] feature
     122* [wikitr:/Help/CommandLineOptions Command line options] - how to change/load custom settings via command line
     123
     124
     125----
     126Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
     127Back to [wikitr:/Help Main Help]