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

Timestamp:

2025-03-03T04:49:52+01:00 (5 months ago)

Author:

paleid

Comment:

Esperanto version added

Eo:Help/CommandLineOptions

@@ +1 @@
+[[TranslatedPages(revision=47)]]
+[[PageOutline(2)]]
+
+= Komandliniaj Opcioj =
+
+Kvar tipoj de komandliniaj opcioj efikas al JOSM:
+ * La [#Programarguments Programaj argumentoj⤓] rekte kontrolas JOSM. Ili estas nomataj ''args'' de Java.
+ * La [#Javaoptions Java-opcioj⤓] efikas al ĝia medio (JVM) kaj estas kelkfoje nomataj ''VM-argumentoj''.
+ * La [#run-options Run-opcioj⤓] estas implikitaj en WebStart. Kelkaj estas por diagnozo kaj importo.
+ * Kelkaj [#Otheroptions Aliaj opcioj⤓] por helpilaj programoj.
+
+{{{
+#!sh
+# Rulante jar-dosieron
+java [Java-opcioj] -jar josm.jar [Programaj argumentoj]
+
+# Lanĉi Web Start
+javaws [Run-opcioj] -J[Java-opcio] josm.jnlp
+}}}
+
+La [wikitr:/Help/Action/ShowStatusReport Statusa Raporto] el la Helpa menuo listigas la donitajn Programajn argumentojn kaj Java-opciojn.
+Kelkaj [#Examples ekzemploj⤓] por ambaŭ estas montritaj sube.
+
+**Noto:** La termino {{{josm.jar}}} estas komuna mallongigo por la dosiernomoj ''josm-tested.jar'' kaj ''josm-latest.jar''.
+La termino ''josm.jnlp'' ankaŭ reprezentas ''josm-latest.jnlp''.
+Kiel kutime, la komandliniaj argumentoj estas apartigitaj per spaco unu de la alia.
+
+
+== Programaj argumentoj por JOSM ==#Programarguments
+
+La unua argumento povas esti **komando** por JOSM por igi ĝin labori aŭtonome.
+La komandoj estas `render`, `project` aŭ `runjosm` kiel defaŭlto.
+
+La ceteraj argumentoj estas **opcioj** por JOSM.
+Ili povas esti URL-oj, dosiernomoj, koordinatoj, simplaj opcioj kaj opcio=valoro-paroj.
+
+La opcioj por runjosm estas listigitaj sube.
+Ĉe la fundo estas la opcioj por la komandoj [#Programargumentsrendering render⤓] kaj [#Programargumentsproject project⤓].
+
+{{{
+uzo:
+        java -jar josm.jar [<komando>] <opcioj>...
+
+komandoj:
+        runjosm     lanĉi JOSM (defaŭlto, efektivigita kiam neniu komando estas specifita)
+        render      bildigi datumojn kaj konservi la rezulton al bilda dosiero
+        project     konverti koordinatojn de unu koordinata referenca sistemo al alia
+        validate    validigi datumojn
+
+Por detaloj pri la render kaj project komandoj, rulu ilin kun la --help opcio.
+La cetero de ĉi tiu helpa paĝo dokumentas la runjosm komandon.
+
+opcioj:
+        --help|-h                                 Montri ĉi tiun helpon
+        --geometry=widthxheight(+|-)x(+|-)y       Norma unix geometria argumento
+        [--download=]minlat,minlon,maxlat,maxlon  Elŝuti la limigan skatolon
+        [--download=]<URL>                        Elŝuti la lokon ĉe la URL (kun lat=x&lon=y&zoom=z)
+        [--download=]<filename>                   Malfermi dosieron (iu ajn dosiertipo kiu povas esti malfermita per Dosiero/Malfermi)
+        --downloadgps=minlat,minlon,maxlat,maxlon Elŝuti la limigan skatolon kiel kruda GPS
+        --downloadgps=<URL>                       Elŝuti la lokon ĉe la URL (kun lat=x&lon=y&zoom=z) kiel kruda GPS
+        --selection=<searchstring>                Elekti kun la donita serĉo
+        --[no-]maximize                           Lanĉi en maksimumigita reĝimo
+        --reset-preferences                       Restarigi la preferojn al defaŭlto
+
+        --load-preferences=<url-to-xml>           Ŝanĝi preferojn laŭ la XML-dosiero
+
+        --set=<key>=<value>                       Agordi preferan ŝlosilon al valoro
+
+        --language=<language>                     Agordi la lingvon
+
+        --version                                 Montri la version de JOSM kaj eliri
+
+        --status-report                           Montri statusan raporton kun utilaj informoj kiuj povas esti aldonitaj al cimoj
+
+        --debug                                   Printi sencimigajn mesaĝojn al konzolo
+
+        --skip-plugins                            Ignori ŝargi kromprogramojn
+
+        --offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL>
+                                                  Malaktivigi aliron al la donita(j) rimedo(j), apartigitaj per komo
+                                                  <OSM API|JOSM retejo|Kaŝmemoraj ĝisdatigoj|Atestiloj|Ĉio>
+}}}
+
+La `--download=` parto de la elŝuta opcio estas nedeviga.
+La argumentoj `--download`, `--downloadgps` kaj `--selection` estas prilaboritaj en ĉi tiu ordo.
+La valoro `<url-to-xml>` povas indiki lokan dosieron kun `file:relative/path/name.xml`.
+La eroj en la `--offline` valoro estas apartigitaj per komo.
+
+
+== Java-opcioj ==#Javaoptions
+
+Ili kontrolas la Java virtualan maŝinon [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] kaj povas agordi [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html propraĵojn] ene de ĝi. JOSM legas kelkajn el ili rekte, ekzemple `josm.home`. Aliaj kiel `user.language` kaj `user.country` efikas al la defaŭltaj agordoj de la JVM kiuj ankaŭ efikas al JOSM.
+
+{{{
+Java sistemaj propraĵaj opcioj:
+    -Djosm.dir.name=JOSM                      Ŝanĝi la JOSM dosierujnomon
+    -Djosm.pref=/PATH/TO/JOSM/PREF            Agordi la preferan dosierujon
+                                              Defaŭlto (Linux XDG): /home/name/.config/JOSM
+                                              Defaŭlto (Windows): C:\Users\name\AppData\Roaming\JOSM
+    -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Agordi la uzantan datumdosierujon
+                                              Defaŭlto (Linux XDG): /home/name/.local/share/JOSM
+                                              Defaŭlto (Windows): C:\Users\name\AppData\Roaming\JOSM
+    -Djosm.cache=/PATH/TO/JOSM/CACHE          Agordi la kaŝmemoran dosierujon
+                                              Defaŭlto (Linux XDG): /home/name/.cache/JOSM
+                                              Defaŭlto (Windows): C:\Users\name\AppData\Local\JOSM\cache
+    -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Agordi la komunan dosierujon por preferoj,
+                                              uzantaj datumoj kaj ./cache/. Malpli alta prioritato.
+                                              Estos anstataŭigita de specifa agordo.
+    -Xmx...m                                  Agordi maksimuman Java-amasgrandon en megabajtoj.
+                                              Povas eviti Erarojn pri Memormanko.
+}}}
+
+La `-Xmx...m` opcio povas esti utila kiam [wikitr:/Download#Outofmemory Memormanko] eraroj okazas.
+Se vi agordas komunan dosierujon kun `Djosm.home` tiam JOSM kreos la subdosierujojn ./autosave, ./cache kaj ./validator.
+Se valoro havas spacojn, tiam enfermu ĝin en citiloj kiel `"josm dev"`.
+
+Kiam la ne-ASCII signoj en la komandlinio estas fuŝitaj, uzu `-Dfile.encoding=Cp850` por ricevi tekston de Java en alia [https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html kodpaĝo].
+Kiun [https://msdn.microsoft.com/de-de/library/windows/desktop/dd317756%28v=vs.85%29.aspx kodpaĝon] estas uzata montras `chcp⏎` en la terminalo.
+Por UTF-8 en Windows, invoku `chcp 65001` en la Windows terminala fenestro antaŭ ol lanĉi JOSM uzante `java -Dfile.encoding=UTF-8 -jar josm.jar`
+
+JOSMs Debian-pakaĵo `josm-latest` uzas `-Djosm.dir.name=JOSM-latest` por proponi paralelajn instalaĵojn en la XDG-bazaj dosierujoj.
+
+[=#Examples **Ekzemploj por JOSM runjosm opcioj kaj Java-opcioj**]
+{{{
+#!sh
+# Ŝargi tri dosierojn
+  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
+# Elŝuti de OSM laŭ URL kun zomo kaj koordinatoj
+  java -jar josm.jar https://www.openstreetmap.org/#map=18/51.501/-0.124
+# Elŝuti limigan skatolon kaj elekti ĉiun elementon kongruantan kun ĉeno
+  java -jar josm.jar 51.500,-0.126,51.502,-0.122 --selection="Big Ben"
+#
+# Agordi dosierujon por JOSM laŭ propraĵo de la operaciumo
+  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm.jar
+# Citiloj por valoro kun spaco kaj montri JOSM GUI en la angla
+  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
+# Agordi la komunan dosierujon en sub-subdosierujo sub la aktiva komandlinio
+  java -Djosm.home=biketour2017/london -jar josm.jar
+# Pli da memoro kaj sen telefoni hejmen
+  java -Xmx1024m --set=message.notifier.enabled=false  -jar josm.jar
+#
+# Komenci en angla medio kaj enskribi sencimigajn informojn plus mesaĝojn de stderr
+  java -Duser.language=en -jar josm.jar --debug 1>logfile.txt 2>&1
+}}}
+
+
+== Run-opcioj por Java Web Start ==#run-options
+
+La run-opcioj estas legataj de la `javaws` komando. Ili kontrolas la Web Start mekanismon, povas enkapsuli Java-opciojn kaj povas diagnozi Java.
+{{{
+#!sh
+# Kontrolo
+  -offline                  Permesas Web Start JOSM sen interreta aliro
+
+# Enkapsuli
+  -J<java opcio>            Provizas la <java opcion> al la JVM
+  -J-Xmx1024m               Ĉi tie: Agordi maksimuman Java-amasgrandon al 1024 megabajtoj
+
+# Diagnozo
+javaws -viewer            Montras la Kaŝmemoran Rigardilon en la Java Kontrolpanelo
+# Permesas malfermi la Java Kontrolpanelon de la komandlinio.
+
+javaws -clearcache        Forigas ĉiujn ne-instalitajn aplikaĵojn el la kaŝmemoro
+# Egala al 'Forigi Dosierojn kaj Aplikaĵojn' el la 'Provizoraj Dosieragordoj' invokitaj
+# per la 'Agordoj' butono en la 'Ĝenerala' langeto de la Java Kontrolpanelo.
+# javaws -Xclearcache en OpenJDK
+}}}
+
+La `-J` run-opcio prenas sian parton post la J litero kaj provizas tion kiel Java-opcion.
+La [wikitr:/Help/jnlpOptions jnlp-Dosiero] uzata de [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start] ofertas duan vojon por [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html agordi opciojn] por JRE kaj por la JOSM programo rekte.
+
+La `javaws` komando havas kelkajn kontrolopciojn sur ĉiuj sistemoj.
+
+La `-clearcache` opcio kaj malplenigo de la kaŝmemoro per la Java Kontrolpanelo ambaŭ forigos JNLP-bazitajn ikonojn de la labortablo. La JOSM ikono malaperos se ĝi estis metita kiel rezulto de klako en retumilo sur jnlp-dosiero.
+
+== Aliaj opcioj ==#Otheroptions
+
+La Lanĉilo `josm.exe` aka [http://launch4j.sourceforge.net/docs.html#Runtime_options Launch4j] (nur en [wikitr:/Download#Mswindowswrapper MS Windows]) povas doni kelkajn sencimigajn informojn.
+{{{
+#!sh
+josm.exe --j4l-debug      Provas skribi launch4j.log en la aktuala dosierujo
+josm.exe --j4l-dont-wait  Finas la envolvaĵon post invoki JOSM.
+}}}
+
+== Komandlinio por Render kaj Project ==
+
+=== JOSM bildigaj Programaj argumentoj ===#Programargumentsrendering
+
+{{{
+Uzo:
+        java -jar josm.jar render <opcioj>
+
+Priskribo:
+Bildigas datumojn kaj konservas la rezulton al bilda dosiero.
+
+Opcioj:
+        --help|-h                 Montri ĉi tiun helpon
+        --input|-i <file>         Eniga datumdosiernomo (.osm)
+        --output|-o <file>        Eliga bilddosiernomo (.png); defaŭlto estas 'out.png'
+        --style|-s <file>         Stila dosiero por uzi por bildigo (.mapcss aŭ .zip)
+                                  Ĉi tiu opcio povas esti ripetita por ŝargi multajn stilojn.
+        --setting <key>:<value>   Stila agordo (en JOSM alirebla en la stila listo dialogo dekstraklika menuo)
+                                  Aplikiĝas al la lasta stilo ŝargita per la --style opcio.
+        --zoom|-z <lvl>           Elekti zoman nivelon por bildigi. (entjera valoro, 0=tuta tero, 18=strata nivelo)
+        --scale <scale>           Elekti la mapan skalon
+                                  Valoro de 10000 signifas skalon de 1:10000 (1 cm sur la mapo egalas 100 m sur la tero; montra rezolucio: 96 dpi)
+                                  Opcioj --zoom kaj --scale estas reciproke ekskluzivaj.
+        --bounds|-b auto|<min_lon>,<min_lat>,<max_lon>,<max_lat>
+                                  Areo por bildigi, defaŭlta valoro estas 'auto'
+                                  Kun ŝlosilvorto 'auto', la elŝutita areo en la .osm eniga dosiero estos uzata (se registrita).
+        --anchor <lon>,<lat>      Specifi la malsupran maldekstran angulon de la bildiga areo
+                                  Uzata kombinita kun larĝo kaj alto opcioj por determini la areon por bildigi.
+        --width-m <number>        Larĝo de la bildigita areo, en metroj
+        --height-m <number>       Alto de la bildigita areo, en metroj
+        --width-px <number>       Larĝo de la cela bildo, en rastrumeroj
+        --height-px <number>      Alto de la cela bildo, en rastrumeroj
+        --projection <code>       Projekcio por uzi, defaŭlta valoro 'epsg:3857' (reto-Merkatoro)
+        --max-image-size <number> Maksimuma bilda larĝo/alto en rastrumeroj ('0' signifas sen limo), defaŭlta valoro: 20000
+
+Por specifi la bildigitan areon kaj skalon, la opcioj povas esti kombinitaj en diversaj manieroj:
+  * --bounds (--zoom|--scale|--width-px|--height-px)
+  * --anchor (--width-m|--width-px) (--height-m|--height-px) (--zoom|--scale)
+  * --anchor --width-m --height-m (--width-px|--height-px)
+  * --anchor --width-px --height-px (--width-m|--height-m)
+Se nek 'bounds' nek 'anchor' estas donita, la defaŭlta valoro --bounds=auto efikas kaj la limoj de la elŝuta areo en la .osm eniga dosiero estas uzataj.
+
+Ekzemploj:
+  java -jar josm.jar render -i data.osm -s style.mapcss -z 16
+  josm render -i data.osm -s style.mapcss --scale 5000
+  josm render -i data.osm -s style.mapcss -z 16 -o image.png
+  josm render -i data.osm -s elemstyles.mapcss --setting hide_icons:false -z 16
+  josm render -i data.osm -s style.mapcss -s another_style.mapcss -z 16 -o image.png
+  josm render -i data.osm -s style.mapcss --bounds 21.151,51.401,21.152,51.402 -z 16
+  josm render -i data.osm -s style.mapcss --anchor 21.151,51.401 --width-m 500 --height-m 300 -z 16
+  josm render -i data.osm -s style.mapcss --anchor 21.151,51.401 --width-m 500 --height-m 300 --width-px 1800
+  josm render -i data.osm -s style.mapcss --scale 5000 --projection epsg:4326
+}}}
+
+=== JOSM projekciaj Programaj argumentoj ===#Programargumentsprojection
+
+{{{
+Uzo:
+        java -jar josm.jar project <opcioj> <crs> +to <crs> [file]
+
+Priskribo:
+Konvertas koordinatojn de unu koordinata referenca sistemo al alia.
+
+Opcioj:
+        --help|-h         Montri ĉi tiun helpon
+        -I                Ŝanĝi enigan kaj eligan crs
+        -r                Ŝanĝi ordon de enigaj koordinatoj (oriento/nordo, lon/lat)
+        -s                Ŝanĝi ordon de eligaj koordinatoj (oriento/nordo, lon/lat)
+
+<crs>:
+La formato por eniga kaj eliga koordinata referenca sistemo estas simila al tiu de la PROJ.4 programaro.
+
+[file]:
+Legas enigajn datumojn de unu aŭ pli da dosieroj listigitaj kiel poziciaj argumentoj. Kiam neniu dosiero estas donita, aŭ la dosiernomo estas "-", datumoj estas legataj de norma enigo.
+
+Ekzemploj:
+    java -jar josm.jar project +init=epsg:4326 +to +init=epsg:3857 <<<"11.232274 50.5685716"
+       => 1250371.1334500168 6545331.055189664
+
+    java -jar josm.jar project +proj=lonlat +datum=WGS84 +to +proj=merc +a=6378137 +b=6378137 +nadgrids=@null <<EOF
+    11d13'56.19"E 50d34'6.86"N
+    118d39'30.42"W 37d20'18.76"N
+    EOF
+       => 1250371.1334500168 6545331.055189664
+          -1.3208998232319113E7 4486401.160664663
+}}}
+
+
+== Vidu ankaŭ ==
+* [wikitr:/Download#Troubleshooting Sencimigo de Java]
+* [wikitr:/InstallNotes Instalaj notoj]
+* [wikitr:/Help/Preferences Preferoj] - Preferoj superrigardo
+
+----
+Reen al [wikitr:/Help Ĉefa Helpo]