Changes between Version 2 and Version 3 of Ru:Help/CommandLineOptions


Ignore:
Timestamp:
2018-02-16T11:07:48+01:00 (6 years ago)
Author:
ak099
Comment:

обновил до ревизии 25

Legend:

Unmodified
Added
Removed
Modified
  • Ru:Help/CommandLineOptions

    v2 v3  
    1 [[TranslatedPages(revision=22)]]
     1[[TranslatedPages(revision=25)]]
    22
    3 == Получение актуальных сведений об использовании ==
    4 Чтобы получить актуальные на данный момент сведения об использовании параметров командной строки (информация будет переведённой на ваш язык) запустите JOSM с параметром --help:
    5 {{{
    6 java -jar josm-tested.jar --help
     3= Параметры командной строки =
     4{{{#!comment
     5Нет оглавления.
    76}}}
    8 
    9 Соответствующая часть исходного кода: [source:trunk/src/org/openstreetmap/josm/gui/MainApplication.java#L130 org/openstreetmap/josm/gui/MainApplication.java#L130].
    10 
    11 = Приведённые ниже сведения могут быть устаревшими =
    12 == Использование ==
    13 
    14 Использование:
    15 {{{
    16 #!sh
    17 java <опции Java> <опции JOSM JVM> -jar josm-tested.jar <опции после jar> [файл]
    18 }}}
    19 
    20 или
     7JOSM управляется тремя группами параметров командной строки.
     8Наиболее важны [#Programarguments аргументы программы], затем [#Javaoptions опции Java]. Только на Web Start влияют [#run-options опции запуска]. См. [#Examples примеры]
    219
    2210{{{
    2311#!sh
    24 javaws https://josm.openstreetmap.de/download/josm.jnlp
    25 javaws [опции] [URL или путь к файлу josm.jnlp]
     12# Запуск jar
     13java [опции Java] -jar josm-tested.jar [аргументы программы]
     14
     15# Запуск через Web Start
     16javaws [опции запуска] -J[опции Java] josm.jnlp
    2617}}}
    2718
     19=== Аргументы программы ===#Programarguments
    2820
    29 Документация Java 8 о javaws: https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html
     21Также именуются ''аргументами после jar'' здесь или ''args'' в документации Oracle.
    3022
    31 === Опции Java ===
     23Первый аргумент воспринимается JOSM как ''команда''. Возможные команды: `runjosm` для обычного запуска (по умолчанию), `render` для генерации файла изображения и `project` для преобразования координат. Если JOSM не может распознать команду, он выполняет команду, используемую по умолчанию.
     24
     25Следующие аргументы — это ''опции'' для JOSM. Они разделяются пробелами. Это могут быть URLы, имена файлов, координаты, простые опции и пары опция=аргумент. Полный список команд и опций показан ниже:
     26
    3227{{{
    33 -Xmx...m                                  Задаёт максимальный размер кучи (heap) Java в мегабайтах
     28Использование:
     29  java <опции java> -jar josm.jar [<команда>] <опции>
     30
     31Команды:
     32  runjosm     запустить JOSM (по умолчанию, выполняется, если никакой команды не указано)
     33  render      выполнить отрисовку данных и сохранить результат в файл изображения
     34  project     преобразовать координаты из одной системы координат в другую
     35
     36Для более подробных сведений о командах render и project запустите их с опцией --help.
     37Остаток этой страницы документирует команду runjosm.
     38
     39Опции:
     40  --help|-h                                 Показать эту справку
     41  --geometry=widthxheight(+|-)x(+|-)y       Стандартный аргумент unix geometry
     42  [--download=]minlat,minlon,maxlat,maxlon  Скачать данные в указанной области
     43  [--download=]<URL>                        Скачать область по URL, содержащему
     44                                            координаты наподобие lat=x&lon=y&zoom=z
     45  [--download=]<имя файла>                  Открыть файл (то же, что и меню Файл/Открыть)
     46  --downloadgps=minlat,minlon,maxlat,maxlon Скачать указанную область, как "сырой" GPS
     47  --downloadgps=<URL>                       Скачать по URL, как "сырой" GPS
     48  --selection=<строка поиска>               Выделить объекты по результатам заданного поиска
     49  --[no-]maximize                           Запустить JOSM развёрнутым во весь экран
     50  --reset-preferences                       Сбросить настройки к значениям по умолчанию
     51  --load-preferences=<url-to-xml>           Импортировать настройки из XML-файла
     52  --set=<key>=<value>                       Присвоить настройке key значение value
     53  --language=<язык>                         Задать язык интерфейса
     54  --version                                 Показать версию JOSM и выйти
     55  --debug                                   Выводить отладочные сообщения в консоль
     56  --skip-plugins                            Пропустить загрузку модулей
     57  --offline=[osm_api,][josm_website,][all]  Отключить доступ к указанным ресурсам
    3458}}}
    3559
    36 При выполнении некоторых задач JOSM весьма прожорлив в отношении памяти. С одной стороны, может быть необходимо настроить размер памяти -Xmx для поддержки большего количества плагинов JOSM и дополнительных функций редактирования в JOSM. С другой стороны, на медленных компьютерах или компьютерах с меньшим количеством памяти можно достичь большей стабильности, ограничив использование памяти JOSM.  Ниже приведены примеры настройки памяти Java по порядку от компьютеров с меньшей памятью до компьютеров с большим количеством свободной памяти.
     60Часть `--download=` опции download является не обязательной.
     61Аргументы `--download`, `--downloadgps` и `--selection` обрабатываются именно в таком порядке, как перечислены здесь.
     62Значение `<url-to-xml>` может указывать на локальный файл `file:relative/path/name.xml`.
     63Элементы значения `--offline` разделяются запятыми.
     64
     65
     66=== Опции Java ===#Javaoptions
     67
     68Опции Java именуются также ''опциями JOSM JVM'' здесь или ''аргументами VM'' в [wiki:/Ru:Help/Action/ShowStatusReport отчёте о состоянии]. В этом отчёте можно увидеть их, а также  аргументы программы. Они управляют виртуальной машиной Java [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] и могут задавать [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html свойства] внутри неё. JOSM читает некоторые из них, например `josm.home` и `user.language`.
    3769{{{
    38 -Xmx256m
    39 -Xmx512m
    40 -Xmx768m
    41 -Xmx1024m
    42 -Xmx1536m
    43 -Xmx2048m
     70Опции Java:
     71  -Djosm.dir.name=JOSM                      Изменить имя каталога JOSM
     72  -Djosm.pref=/PATH/TO/JOSM/PREF            Задать каталог настроек
     73                                            По умолчанию: C:\Users\name\AppData\Roaming\JOSM
     74  -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Задать каталог пользовательских данных
     75                                            По умолчанию: /home/name/.local/share/JOSM
     76  -Djosm.cache=/PATH/TO/JOSM/CACHE          Задать каталог кэша
     77                                            По умолчанию: <...>
     78  -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Задать общий каталог для настроек, пользовательских
     79                                            данных и ./кэша/. Эта опция имеет более низкий приоритет
     80                                            и будет перекрываться вышеуказанными опциями.
     81  -Xmx...m                                  Задать максимальный размер кучи Java (heap) в мегабайтах.
     82                                            Позволяет избежать ошибок о недостаточности памяти.
    4483}}}
    4584
    46 === Опции JOSM JVM ===
     85Опция `-Xmx...m` может быть полезна при возникновении ошибок [wiki:/Ru:Download#Outofmemory «не хватает памяти»].
     86Если вы укажете общий каталог опцией `Djosm.home`, то JOSM создаст подкаталоги ''./autosave'', ''./cache'' и ''./validator''.
     87Если значение содержит пробелы, заключите их в кавычки, вот так: `"josm dev"`.
    4788
    48 provided as Java system properties
     89=== Опции запуска ===
     90Опции запуска следуют за командой `javaws`. Они управляют механизмом Web Start и средой для JVM.
    4991{{{
    50 -Djosm.pref=/PATH/TO/JOSM/PREF            Указывать путь к каталогу настроек
    51 -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Указывать путь к каталогу данных пользователя
    52 -Djosm.cache=/PATH/TO/JOSM/CACHE          Указывать путь к каталогу кэша
    53 -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Перебазирует все 3 каталога в homedir.
    54 -Djosm.home=/path/to/JOSM/folder/         Изменить каталог для всех пользовательских настроек. Каталог кэша будет в homedir/cache
    55 }}}
    56 **Примечание**: `-Djosm.home` имеет меньший приоритет, т.к. более специфичные настройки перекрывают более общую
    57 
    58 === Опции после jar ===
    59 
    60 Эти опции необходимо вставлять после части -jar josm.jar командной строки.
    61 
    62 {{{
    63 --help|-h                                 Показать эту справку
    64 --geometry=widthxheight(+|-)x(+|-)y       Стандартный параметр геометрии Unix
    65 [--download=]minlat,minlon,maxlat,maxlon  Скачать область в пределах рамки
    66 [--download=]<URL>                        Скачать область по URL (с lat=x&lon=y&zoom=z)
    67 [--download=]<filename>                   Открыть файл (любой тип файла, который можно открыть через меню Файл/Открыть)
    68 --downloadgps=minlat,minlon,maxlat,maxlon Скачать область в пределах рамки, как необработанные данные GPS
    69 --downloadgps=<URL>                       Скачать область по URL (с lat=x&lon=y&zoom=z), как необработанные данные GPS
    70 --selection=<searchstring>                Выбор с учетом поиска
    71 
    72 --[no-]maximize                           Запуск с окном, развёрнутым во весь экран
    73 --reset-preferences                       Сброс к настройкам по умолчанию
    74 --load-preferences=<url-to-xml>           Изменить настройки, загрузив их из указанного XML-файла
    75 --set=<key>=<value>                       Задать значение настройки key равным value
    76 --language=<language>                     Выбрать язык
    77 --version                                 Показать версию JOSM и выйти
    78 --debug                                   Вывод отладочных сообщений в консоль
    79 --skip-plugins                            Пропустить загрузку модулей
    80 --offline=<osm_api|josm_website|all>      Отключить доступ к указанным ресурсам, разделённым запятыми
     92  -offline                  Позволяют выполнить Web Start JOSM без доступа к Интернету
     93  -J<опции java>            Передаёт <опции java> в JVM
     94  -J-Xmx1024m               Здесь: задать максимальный размер кучи Java равным 1024 МБ
    8195}}}
    8296
    83 Примеры:
     97Опция `-J` берёт свою часть после буквы J и передаёт её в качестве опций Java.
     98[wiki:/Ru:Help/jnlpOptions Файл .jnlp], используемый [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start], предлагает и другой способ [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html  задать опции] для JRE и непосредственно на программы JOSM.
     99
     100
     101=== Примеры ===
    84102{{{
    85103#!sh
    86 java -jar josm.jar track1.gpx track2.gpx london.osm
    87 java -jar josm.jar https://www.openstreetmap.org/#map=13/43.2/11.1
    88 java -jar josm.jar london.osm --selection=http://www.ostertag.name/osm/OSM_errors_node-duplicate.xml
    89 java -jar josm.jar 43.2,11.1,43.4,11.4
    90 java -jar josm.jar --set=expert=true
    91 java -Djosm.pref=$XDG_CONFIG_HOME -Djosm.userdata=$XDG_DATA_HOME -Djosm.cache=$XDG_CACHE_HOME -jar josm.jar
    92 java -Djosm.home=/home/user/.josm_dev -jar josm.jar
    93 java -Xmx1024m -jar josm.jar
     104# Загрузить три файла
     105  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
     106# Скачать с OSM по URL с масштабом и координатами
     107  java -jar josm.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
     108# Скачать область и выделить все элементы, совпадающие со строкой
     109  java -jar josm.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
     110#
     111# Задать каталог для JOSM согласно переменной окружения из операционной системы
     112  java -Djosm.pref=$XDG_CONFIG_HOME jar josm.jar
     113# Кавычки для значения с пробелом
     114  java -Djosm.dir.name="josm dev" -jar josm.jar
     115# Задать общий каталог в подкаталоге
     116  java -Djosm.home=biketour2017/london -jar josm.jar
     117# Больше памяти в среде с французским интерфейсом
     118  java -Xmx1024m -Duser.language=fr -jar josm.jar
     119#
     120# Журналировать всё происходящее на английском
     121  java -verbose  -jar josm-latest.jar --language=en --debug >WhatsUp.txt
    94122}}}
    95123
    96 Параметры `--download`, `--downloadgps` и `--selection` обрабатываются в этом порядке.
    97 Убедитесь, что вы загрузили какие-либо данные, если используете `--selection`.
    98 
    99124=== Смотрите также ===
    100 * [wiki:Help/Preferences Настройки] - обзорная страница обо всех настройках
    101 * [[Help/jnlpOptions]]
     125* [wiki:Ru:Download#Troubleshooting Решение проблем с Java]
     126* [wiki:Ru:InstallNotes Примечания по установке]
     127* [wiki:Ru:Help/Preferences Настройки] - обзорная страница обо всех настройках