Добавление нового языка интерфейса в ONLYOFFICE Docs для Linux

Введение

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

В данной статье объясняется, как это можно сделать.

Участие в переводе

Принять участие в процессе перевода можно двумя способами:

• Переведите ONLYOFFICE Docs (в случае необходимости вместе с ONLYOFFICE Workspace и ONLYOFFICE Mail), используя нашу Систему переводов. Это довольно просто. Когда перевод будет завершен, языковые файлы интерфейса будут включены в ближайший выпуск. Мы также можем выслать вам эти файлы для проверки. Если вы хотите принять участие в переводе, вы всегда можете написать нам по адресу электронной почты documentation@onlyoffice.com.

• Или же можно использовать наш репозиторий GitHub, чтобы получить языковые файлы и перевести их с помощью привычных средств. Файлы находятся по следующим путям:

  Редактор документов

  • https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/main/locale
  • https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/mobile/locale

  Редактор презентаций

  • https://github.com/ONLYOFFICE/web-apps/tree/master/apps/presentationeditor/main/locale
  • https://github.com/ONLYOFFICE/web-apps/tree/master/apps/presentationeditor/mobile/locale

  Редактор таблиц

  • https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/main/locale
  • https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/mobile/locale

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

Проверка переведенных файлов

Установите ONLYOFFICE Docs на своем компьютере. Инструкции по установке доступны для Ubuntu и производных и для дистрибутивов на базе RPM.

Если вы используете нашу систему переводов, вам надо будет обратиться к нам по адресу электронной почты documentation@onlyoffice.com, чтобы мы могли выслать вам переведенные файлы.

Когда вы получите языковые файлы интерфейса в формате JSON, положите их по следующим путям:

Редактор документов

• documentserver/web-apps/apps/documenteditor/main/locale
• documentserver/web-apps/apps/documenteditor/mobile/locale

Редактор презентаций

• documentserver/web-apps/apps/presentationeditor/main/locale
• documentserver/web-apps/apps/presentationeditor/mobile/locale

Редактор таблиц

• documentserver/web-apps/apps/spreadsheeteditor/main/locale
• documentserver/web-apps/apps/spreadsheeteditor/mobile/locale

Где documentserver — это папка, в которой установлен ONLYOFFICE Docs.

В Linux documentserver — это папка /var/www/onlyoffice/documentserver.

После этого откройте любой документ, добавив в ссылку на документ параметр ?lang=your_lang_code.

примечание

Чтобы открыть редакторы с интерфейсом на болгарском языке, этот параметр надо задать следующим образом:

?lang=bg

Если все сделано правильно, вы увидите, что интерфейс редакторов переключился на ваш язык с вашими переводами.

Обновление переведенных файлов

После того, как вы проверите перевод (или после того, как ONLYOFFICE Docs обновится), может потребоваться поправить файлы и снова загрузить их на сервер. Для обеспечения более высокой производительности файлы кэшируются, и вы (а также другие пользователи ONLYOFFICE Docs) не увидите изменений, пока не будет очищен кэш сервера.

Это можно сделать следующим образом:

1. Запустите следующий скрипт, чтобы очистить кэш:

   sudo documentserver-flush-cache.sh

   примечание

   В более старых версиях ONLYOFFICE Docs требовалось вручную редактировать конфигурацию nginx. Сейчас все действия выполняются автоматически с помощью приведенного выше скрипта.

После этого кэш должен быть сброшен для всех пользователей сервера, и переводы интерфейса будут обновлены.