Changes between Version 27 and Version 34 of Help/Preferences


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences

    v27 v34  
    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 [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)]]
     12{{{#!comment
     13English names
     14[[TitleIndex(Help/Preferences/,hideprefix,exclude=*Advanced,format=compact)]]
    1015
    11 Most of the settings can be reached via menus
    12 * [[Help/Action/Preferences]]
    13 * [[Help/Preferences/Advanced]]
     16The same list with the translated names:
     17[wikitr:/Help/Preferences/Audio Audio], [wikitr:/Help/Preferences/Connection Connexion], [wikitr:/Help/Preferences/Display Affichage], [wikitr:/Help/Preferences/Imagery Imagerie], [wikitr:/Help/Preferences/ImportExport Importation Exportation], [wikitr:/Help/Preferences/Map Carte], [wikitr:/Help/Preferences/Plugins Greffons], [wikitr:/Help/Preferences/RemoteControl Contrôle à Distance], [wikitr:/Help/Preferences/Shortcuts Raccourcis clavier], [wikitr:/Help/Preferences/Toolbar barre d'outils], [wikitr:/Help/Preferences/Validator Validateur]
     18}}}
     19
    1420
    1521== Other preferences ==
     22* [wikitr:"/Help/JOSM interface customization" JOSM interface customization]
    1623
    17 * [[Help/JOSM interface customization]]
    1824
    19 == JOSM preference/data/cache directories ==
     25== JOSM preference/data/cache directories ==#JOSMpreferencedatacachedirectories
     26{{{#!comment
     27#JOSMpreferencedatacachedirectories is called from Help/Preferences/Plugins - Manual installation
     28}}}
    2029
    2130JOSM stores 3 kinds of files in different directories:
    … …  
    2433 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.
    2534
    26 The default location of the directories depends on your operating system.
     35The 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]
    2736
    2837=== Windows ===
    29 
    30 '''Preferences''' and '''user data''' is stored in
     38**Preferences** and **user data** is stored in
    3139{{{
    3240%APPDATA%\JOSM
    … …  
    3442To 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.
    3543
    36 The '''cache''' is located in
     44The **cache** is located in
    3745{{{
    3846%LOCALAPPDATA%\JOSM\cache
    … …  
    4553
    4654=== MacOS===
    47 
    4855On MacOS, the default locations are as follows:
    4956 Preferences:: `Users/<YourName>/Library/Preferences/JOSM`
    … …  
    5259
    5360=== Linux ===
    54 
    5561Since r11162, JOSM uses the [https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] for fresh installations, i.e.
    5662 Preferences:: `$HOME/.config/JOSM`
    … …  
    6571 Cache:: `$HOME/.josm/cache`
    6672
     73If JOSM is installed via flatpak, the locations are
     74 Preferences:: `$HOME/.var/app/org.openstreetmap.josm/config`
     75 User data:: `$HOME/.var/app/org.openstreetmap.josm/data`
     76 Cache:: `$HOME/.var/app/org.openstreetmap.josm/cache`
     77
     78
    6779JOSM 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.
    6880
    69 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.
     81Note 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`.
    7082
    71 === Customization (all operating systems) ===
    72 
     83=== Customization (all operating systems) === #Customizationalloperatingsystems
    7384==== Setting all 3 locations ====
    74 
    75 The locations can be set using system properties specified from the [[Help/CommandLineOptions|commandline]]:
     85The locations can be set using system properties specified from the [wikitr:/Help/CommandLineOptions command line]:
    7686 Preferences:: `-Djosm.pref=...`
    7787 User data:: `-Djosm.userdata=...`
    … …  
    8494
    8595==== Setting a common directory ====
    86 
    8796Alternatively, all 3 locations can be moved to a common location using the system property `-Djosm.home=...`.
    8897For example with
    … …  
    96105
    97106==== Changing the directory base name ====
    98 
    99107Instead 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:
    100 {{{
     108{{{#!sh
    101109java -Djosm.dir.name=JOSM-dev -jar josm-latest.jar
    102110}}}
    … …  
    108116(For locations in the style prior to r11162, the lower-case version with the prepended dot will be used, e.g. `$HOME/.josm-dev`.)
    109117
     118
    110119=== preferences.xml Schema ===
     120See [/preferences-1.0.xml].
    111121
    112 http://josm.openstreetmap.de/preferences-1.0
    113 
    114 Some descriptions can be found in [[Help/Preferences/ImportExport]] (stub)
     122Some descriptions can be found in [wikitr:/Help/Preferences/ImportExport Custom configuration XML files for JOSM]
    115123
    116124=== Auto save subfolder ===
     125Utilized by [wikitr:/Help/Action/AutoSave autosave function].
    117126
    118 Utilized by [wiki:/Help/Action/AutoSave autosave function].
    119127
    120128== See also ==
    121 * [[Help/ResetPreferences]] - ways to reset preferences
    122 * [[Help/Action/AutoSave]] feature
    123 * [[Help/CommandLineOptions]] - how to change/load custom settings via command line
     129* [wikitr:/Help/Action/About#InstallationDetails Installation details]
     130* [wikitr:/Help/ResetPreferences Reset preferences] - ways to reset preferences
     131* [wikitr:/Help/Action/AutoSave Autosave] feature
     132* [wikitr:/Help/CommandLineOptions Command line options] - how to change/load custom settings via command line
     133
     134
     135----
     136Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
     137Back to [wikitr:/Help Main Help]