Changes between Initial Version and Version 1 of Fr:Help/CommandLineOptions


Ignore:
Timestamp:
2019-08-22T18:58:50+02:00 (6 years ago)
Author:
leni
Comment:

created fr: translation

Legend:

Unmodified
Added
Removed
Modified
  • Fr:Help/CommandLineOptions

    v1 v1  
     1[[TranslatedPages(revision=36)]]
     2= Options en ligne de commande =
     3
     4Quatre types d'options en ligne de commande affectent JOSM:
     5 * Les [#Programarguments paramètres du programme] contrôlent directement JOSM. Ils sont appelés ''args'' par Java.
     6 * Les [#Javaoptions options Java (Java options)] affectent son environnement (JVM) et sont parfois appelées ''paramètres VM (VM arguments)''.
     7 * Seules les [#run-options options de Démarrage (run-options)] sont disponibles dans Web Start.
     8 * Quelques [#Otheroptions autres options] pour le diagnostic et les dispositifs de lancement.
     9
     10{{{
     11#!sh
     12# Exécution d'un jar
     13java [Java options] -jar josm-tested.jar [Program arguments]
     14
     15# Lancement de Web Start
     16javaws [run-options] -J[Java option] josm.jnlp
     17}}}
     18
     19Le [wikitr:/Help/Action/ShowStatusReport rapport d'État] énumère les paramètres du programme (Program arguments) et les options Java donnés dans sa deuxième section.
     20Quelques [#Examples exemples] pour les deux cas sont présentés ci-dessous.
     21Comme d'habitude dans les quatre types, les paramètres sont séparés les uns des autres par des espaces.
     22
     23== Paramètres du programme (Program arguments) ==#Programarguments
     24
     25Le premier argument peut être une **instruction** permettant à JOSM de le rendre autonome.
     26Si JOSM ne peut pas reconnaître le premier argument comme une instruction, alors `runjosm` est supposé etre l'instruction par défaut.
     27
     28Les autres paramètres sont des **options** pour JOSM. 
     29Il peut s'agir d'URL, de noms de fichiers, de coordonnées, de simples options et de paires option=valeur.
     30La liste complète des instructions et des options est présentée ci-dessous :
     31
     32{{{
     33usage:
     34  java <java options> -jar josm.jar [<command>] <options>
     35
     36commands:
     37  runjosm     lancer JOSM (par défaut, exécuté lorsqu'aucune instruction (command) n'est spécifiée)
     38  render      restituer les données et enregistrer le résultat dans un fichier image
     39  project     convertir les coordonnées d'un système de référence de coordonnées à un autre
     40
     41Pour plus de détails sur les commandes de rendu et de projet, exécutez-les avec l'option --help
     42Le reste de cette page d'aide documente les instructions d'exécution de josm.
     43
     44options:
     45  --help|-h                                                Afficher cette aide
     46  --geometry=widthxheight(+|-)x(+|-)y                      Paramètres de géométrie unix standards
     47  [--download=]minlat,minlon,maxlat,maxlon                 Télécharger la zone délimitée
     48  [--download=]<URL>                                       Téléchargez l'URL de l'emplacement qui a
     49                                                           des coordonnées du type lat=x&lon=y&zoom=z
     50  [--download=]<filename>                                  Ouvrir un fichier (comme Menu/Fichier/Ouvrir)
     51  --downloadgps=minlat,minlon,maxlat,maxlon                Télécharger la zone délimitée en tant que GPS brut
     52  --downloadgps=<URL>                                      Télécharger la position en tant que GPS brut
     53  --selection=<searchstring>                               Sélectionner avec la requête spécifiée
     54  --[no-]maximize                                          Lancement en mode maximalisé
     55  --reset-preferences                                      Réinitialiser les préférences par défaut
     56  --load-preferences=<url-to-xml>                          Importer les préférences à partir d'un fichier XML
     57  --set=<key>=<value>                                      Définir préférence de clé sur valeur
     58  --language=<language>                                    Définir la langue
     59  --version                                                Affiche la version JOSM et quitte l'application
     60  --debug     or   --trace                                 Imprimer les messages de débogage vers la console
     61  --skip-plugins                                           Ignorer les greffons de chargement
     62  --offline=[osm_api,][josm_website,][certificates,][all]  Désactiver l'accès aux ressources de la liste.
     63}}}
     64
     65La partie `--download=` de l'option de téléchargement est facultative.
     66Les paramètres `--download`, `--downloadgps` et `--selection` sont traités dans cet ordre.
     67La valeur `<url-to-xml>` peut pointer vers un fichier local avec `file:relative/path/name.xml`.
     68Les éléments dans la valeur `--offline` sont séparés par des virgules.
     69
     70
     71== Options Java (Java options) ==#Javaoptions
     72
     73Ils contrôlent la machine virtuelle Java [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)(en)] et peuvent y définir des [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html propriétés (en)]. JOSM lit certains d'entre elles directement, par exemple `josm.home`. D'autres comme `user.language` et `user.country` affectent les paramètres par défaut de la JVM qui affectent aussi JOSM.
     74
     75{{{
     76java options:
     77  -Djosm.dir.name=JOSM                      Modifier le nom du répertoire JOSM
     78  -Djosm.pref=/PATH/TO/JOSM/PREF            Définir le répertoire des préférences
     79                                            Par défaut : C:\Users\name\AppData\Roaming\JOSM
     80  -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Définir le répertoire des données utilisateur
     81                                            Par défaut : /home/name/.local/share/JOSM
     82  -Djosm.cache=/PATH/TO/JOSM/CACHE          Définir le répertoire du cache
     83                                            Par défaut : <...>
     84  -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Définissez le répertoire commun pour les préférences.
     85                                            user data and ./cache/. Lower precedence.
     86                                            Sera écrasé par un réglage particulier.
     87  -Xmx...m                                  Définir la taille maximale de la pile Java en mégaoctets.
     88                                            Pourrait éviter les erreurs "Out-of-Memory".
     89}}}
     90
     91L'option `-Xmx...m` peut être utile en cas d'erreurs de [wikitr:/Download#Outofmemory mémoire insuffisante (Out of Memory) (en)].
     92Si vous définissez un répertoire commun avec `Djosm.home` alors JOSM créera les sous-répertoires ./autosave, ./cache et ./validator.
     93Si une des valeurs possède des espaces, mettez-la entre guillemets comme `"josm dev"`.
     94Lorsque les caractères non ASCII de l'invite de commandes sont embrouillés, utilisez `-Dfile.encoding=Cp850` pour recevoir le texte de Java dans une autre [https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html page de code (en)].
     95La [https://msdn.microsoft.com/de-de/library/windows/desktop/dd317756%28v=vs.85%29.aspx page de code (en)] utilisée affiche `chcp⏎` dans le terminal.
     96
     97[=#Examples **Exemples**]
     98{{{
     99#!sh
     100# Charger trois fichiers
     101  java -jar josm-tested.jar track1.gpx BigBen.jpg "london data.osm"
     102# Télécharger depuis OSM en fonction d'une URL avec un zoom et des coordonnées
     103  java -jar josm-tested.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
     104# Télécharger une zone de délimitation et sélectionner chaque élément correspondant à une chaîne de caractères.
     105  java -jar josm-tested.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
     106#
     107# Définir le répertoire pour JOSM en fonction d'une des propriétés du système d'exploitation
     108  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm-tested.jar
     109# Citations pour une valeur avec des espaces et montrer l'interface graphique de JOSM en anglais
     110  java -Djosm.dir.name="josm dev" -jar josm-latest.jar --language=en
     111# Définir le répertoire commun dans un sous-répertoire sous l'invite de commandes active
     112  java -Djosm.home=biketour2017/london -jar josm-tested.jar
     113# Plus de mémoire dans la variante canadienne dans un environnement anglophone
     114  java -Xmx1024m -Duser.language=en -Duser.country=CA -jar josm-latest.jar
     115#
     116# Log debug info and do not get disturbed by JOSM phoning home
     117  java -verbose -jar josm-latest.jar --set=message.notifier.enabled=false --debug >WhatsUp.txt
     118}}}
     119
     120
     121== Options de Démarrage (Run-options) ==#run-options
     122Les options de lancement sont utilisées par la commande `javaws`. Ils contrôlent le mécanisme Web Start et peuvent encapsuler les options Java.
     123
     124{{{
     125  -offline                  Permet de démarrer Web Start JOSM sans accès à Internet
     126  -J<java option>           Fournit <java option> à JVM
     127  -J-Xmx1024m               Ici : Définir la taille maximale de la pile Java à 1024 mégaoctets
     128}}}
     129
     130L'option de Démarrage `-J` prend sa part derrière la lettre J et fournit cela comme option Java.
     131The [wikitr:/Help/jnlpOptions jnlp-File] used by [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start] offers a second way to [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html  set options] for JRE and for the JOSM program directly.
     132
     133== Autres options ==#Otheroptions
     134La commande `javaws` a quelques options de contrôle sur tous les systèmes.
     135Sous [wikitr:/Download#Mswindowswrapper MS Windows], seul le lanceur `josm.exe` dit Launch4j peut donner des informations de débogage (nécessite Java 64-bit sur Windows 64-bit). 
     136{{{
     137#!sh
     138# Options de commande :
     139javaws -viewer            Affiche le visualiseur du cache dans le panneau de configuration Java
     140# Permet d'ouvrir le panneau de configuration de Java à partir de la ligne de commande.
     141
     142javaws -clearcache        Supprime toutes les applications non installées du cache
     143# Équivalent à "Supprimer les fichiers et applications" dans les "Paramètres des fichiers temporaires" qui sont appelés.
     144# par le bouton "Paramètres" dans l'onglet "Général" du panneau de configuration Java.
     145# javaws -Xclearcache on OpenJDK
     146
     147
     148# Avec MS Windows :
     149josm.exe --j4l-debug      Essaye d'écrire un launch4j.log dans le répertoire courant
     150josm.exe --j4l-dont-wait  Ends the wrapper after invoking JOSM.
     151}}}
     152L'option `-clearcache` et l'effacement du cache via le panneau de configuration Java suppriment toutes deux les icônes basées sur JNLP du bureau. L'icône de JOSM disparaîtra si elle a été placée à la suite d'un clic sur un fichier jnlp dans le navigateur Web.
     153
     154
     155=== Voir également ===
     156* [wikitr:/Download#Troubleshooting Résolution des problèmes Java]
     157* [wikitr:/InstallNotes Notes d'Installation]
     158* [wikitr:/Help/Preferences Préférences] - Vue d'ensemble des préférences
     159
     160----
     161Retour à l'[wikitr:/Help Aide principale]