Перейти к основному содержимому

Запуск десктопных редакторов с параметрами

Введение​

Иногда может потребоваться запустить десктопные редакторы для выполнения определенной задачи, например чтобы создать новый файл при запуске приложения, открыть существующий файл только для просмотра или запустить приложение в режиме отладки. Это можно сделать с помощью флагов командной строки.

Список доступных флагов​

Ниже приведены флаги, которые можно использовать при запуске десктопных редакторов, и их краткое описание.

Запуск десктопных редакторов в режиме отладки​

Этот параметр можно использовать во всех операционных системах.

--ascdesktop-support-debug-info — используется для запуска десктопных редакторов в режиме отладки с возможностью открыть консоль. Чтобы начать работу в режиме отладки, щелкните правой кнопкой мыши по любому редактируемому полю на верхней панели инструментов (например, по списку шрифтов) и выберите пункт Inspect Element. Также можно нажать клавишу F1, чтобы открыть окно DevTools.

Начиная с версии 7.1, можно также использовать флаг --ascdesktop-support-debug-info-keep, указав нужное значение:

--ascdesktop-support-debug-info-keep=1 — включает режим отладки постоянно, и для его активации не требуется отдельный параметр (параметр сохраняется в файле настроек приложения).

--ascdesktop-support-debug-info-keep=0 — отключает режим отладки постоянно, и для его активации требуется отдельный параметр (параметр сохраняется в файле настроек приложения).

--ascdesktop-support-debug-info-keep=default — восстанавливает настройку по умолчанию (удаляет параметр из файла настроек приложения).

Inspect element

Настройка окна десктопных редакторов​

Эти параметры можно использовать в ОС Linux.

--system-title-bar — используется для запуска десктопных редакторов в системном окне.

System window

Команда запуска зависит от типа установки приложения. Подробнее см. в разделе Использование флагов в различных операционных системах ниже.

--custom-title-bar — используется для запуска десктопных редакторов в стандартном (не системном) окне. Этот флаг отменяет действие флага --system-title-bar.

Standard window

После запуска приложения с одним из этих флагов выбранный режим заголовка окна сохраняется в настройках приложения и применяется при всех последующих запусках, даже без флага. Чтобы вернуть прежний режим, один раз запустите приложение с противоположным флагом или удалите параметр titlebar из файла DesktopEditors.conf. Файл настроек находится в папке ~/.config/onlyoffice/, а для версии Flatpak — в папке ~/.var/app/org.onlyoffice.desktopeditors/config/onlyoffice/.

Запуск десктопных редакторов с открытием файла в определенном режиме​

Эти параметры можно использовать в ОС Windows и Linux.

--review=path/to/file — используется для открытия существующего файла DOCX в режиме отслеживания изменений без возможности отключить этот режим. Файлы XLSX и PPTX будут открыты в режиме просмотра, так как режим отслеживания изменений пока не поддерживается в электронных таблицах и презентациях.

--view=path/to/file — используется для открытия существующего файла DOCX, XLSX или PPTX в режиме просмотра без возможности переключиться в режим редактирования.

примечание

Замените path/to/file фактическим полным путем к существующему файлу. Путь к файлу должен быть заключен в двойные кавычки. Например:

--review="C:\Users\username\Documents\Document1.docx" для Windows

--review="/home/username/Documents/Document1.docx" для Linux

--force-use-tab — используется вместе с флагами --review=path/to/file или --view=path/to/file, чтобы открыть существующий файл DOCX в новой вкладке главного окна. В противном случае документ открывается в отдельном окне.

примечание

Примеры совместного использования двух флагов:

--review="C:\Users\username\Documents\Document1.docx" --force-use-tab или --view="C:\Users\username\Documents\Document1.docx" --force-use-tab — для Windows

--review="/home/username/Documents/Document1.docx" --force-use-tab или --view="/home/username/Documents/Document1.docx" --force-use-tab — для Linux

Подключение десктопных редакторов к облаку ONLYOFFICE​

Этот параметр можно использовать во всех операционных системах.

--ignore-certificate-errors — используется для отключения проверки действительности сертификата, чтобы можно было подключить десктопные редакторы к облаку ONLYOFFICE, если на вашем портале ONLYOFFICE используется самоподписанный SSL-сертификат.

Создание новых файлов при открытии десктопных редакторов​

Эти параметры можно использовать во всех операционных системах.

--new:word — используется для запуска десктопных редакторов и создания нового локального файла DOCX.

--new:cell — используется для запуска десктопных редакторов и создания нового локального файла XLSX.

--new:slide — используется для запуска десктопных редакторов и создания нового локального файла PPTX.

--new:form — используется для запуска десктопных редакторов и создания нового локального файла PDF-формы.

Использование флагов в различных операционных системах​

Порядок действий зависит от операционной системы — Windows, Linux или macOS. Выберите соответствующую вкладку, чтобы прочитать подробные инструкции для вашей ОС:

В Windows приложение можно запустить двумя способами: с помощью ярлыка или терминала.

Вариант 1. Запуск приложения с помощью ярлыка:

  1. Щелкните правой кнопкой мыши по ярлыку приложения на рабочем столе.

  2. Выберите пункт Свойства.

  3. Откройте вкладку Ярлык.

  4. В поле «Объект» после пути к приложению введите пробел, а затем нужный флаг.

  5. Нажмите кнопку Применить.

    Shortcut

  6. Для изменения этих настроек потребуются права администратора. Нажмите Продолжить.

  7. Запустите приложение, щелкнув по ярлыку.

Вариант 2. Запуск приложения через окно «Выполнить»:

  1. Нажмите Win+R.

  2. В открывшемся окне Выполнить введите путь к приложению, добавьте пробел, а затем введите нужный флаг, например:

    "%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-info

    Run

  3. Нажмите кнопку OK.