Включить многоязычную проверку орфографии в Collabora Online CODE

Чтобы проверить орфографию на нескольких языках в Collabora Online, добавьте каждый необходимый языковой код в dictionariesнастройки контейнера CODE, перезапустите контейнер и назначьте правильный язык каждому фрагменту текста. Важны обе стороны: сервер должен предоставить доступ к словарям, а документ должен пометить английский, французский или другой фрагмент своим языком. Добавление языка в контейнер само по себе не гарантирует автоматическую идентификацию всех языков в документе.

Что нужно настроить?

Следует рассмотреть два отдельных параметра:

• Словари сервера: Образ Docker CODE по умолчанию включает ограниченный список словарей. Его dictionariesпеременная среды изменяет список языков словаря, который настраивает CODE. В руководстве по SDK Collabora 25.04 описаны коды языков, разделенные пробелами, за которыми может следовать код страны, и отмечается, что ограничение списка помогает избежать ненужного использования ресурсов и работы при запуске.
• Язык документа: Collabora использует язык, присвоенный тексту, для выбора орфографического словаря. Документ может содержать разные языки в разных фрагментах или абзацах, поэтому каждый фрагмент должен быть правильно помечен.

Например, для документа, содержащего фрагменты на английском (США) и французском языках, необходимо включить оба кода на сервере, а английский и французский тексты должны иметь соответствующие языковые настройки. Язык пользовательского интерфейса или раскладка клавиатуры не заменяют ни одну из этих настроек. См. руководство по SDK Collabora Online 25.04 и раздел справки Collabora о выборе языка документа .

Настройка языковых словарей в CODE Docker

Пример Docker Compose

Добавьте необходимые коды локали в виде строки, разделенной пробелами, в окружение сервиса Collabora. В этом примере список ограничивается американским английским, британским английским и французским языками:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    environment:
      dictionaries: "en_US en_GB fr_FR"
      domain: "cloud\.example\.com"
      username: "collabora_admin"
      password: "replace-with-a-long-unique-password"
    ports:
      - "127.0.0.1:9980:9980"

Замените шаблон домена, учетные данные, тег образа и сопоставление портов в соответствии с вашей конфигурацией развертывания. Сохраните существующие настройки обратного прокси и подключения Nextcloud; этот фрагмент кода лишь иллюстрирует, где должен находиться список словарей. Если вы уже используете файл Compose, отредактируйте существующую службу Collabora вместо создания второго контейнера.

Приведенные выше коды языков соответствуют кодам, описанным в Collabora, где локаль может включать код страны. Используйте коды, соответствующие языкам документов, необходимым вашим пользователям. Не следует предполагать, что каждый возможный код имеет подходящий словарь в каждом образе CODE: в руководстве по SDK описано изменение настроенного списка, в то время как установленная сборка и ее словари по-прежнему определяют, что фактически доступно. Перед добавлением менее распространенных локалей проверьте документацию для используемой вами версии образа CODE.

Применить изменение

1. Создайте резервную копию или сохраните текущий файл Compose, чтобы можно было отменить изменения.
2. Обновите dictionariesзначение, указав только те языки, которые необходимы вашим пользователям. Сохраните остальные переменные среды Collabora.
3. Пересоздайте сервис, чтобы Docker передал обновленную среду в контейнер. Для развертывания с помощью Compose запустите команду docker compose up -d --force-recreate collaboraиз каталога, содержащего файл Compose.
4. Проверьте вывод при запуске с помощью команды docker compose logs --tail=100 collabora`.`. Ищите ошибки при запуске или загрузке словаря; не следует рассматривать успешный статус контейнера как доказательство установки конкретного словаря.

Если в вашей системе используется docker runдругой подход, обновите его -e dictionaries="en_US en_GB fr_FR"аргумент и создайте контейнер заново с теми же параметрами сети, тома, прокси и безопасности. Изменение среды в работающем контейнере не меняет среду, в которой он был запущен.

Присвойте каждому отрывку свой язык.

После того, как сервер будет готов, откройте документ в Nextcloud и выделите текст, язык которого вы хотите проверить. В настройках языка Collabora выберите язык для выделенного фрагмента или абзаца; для документа, написанного на одном языке, используйте параметр, который применяет язык ко всему тексту. Названия команд могут немного отличаться в зависимости от версии и макета экрана, но главное — установить язык текста документа, а не просто изменить язык интерфейса. В справке Collabora объясняется, что язык документа определяет словарь, используемый для проверки орфографии, тезауруса и переноса слов.

В документе, содержащем несколько языков, применяйте языковые настройки по частям. Например, выделите абзац на французском языке и установите французский (Франция), затем выделите абзацы на английском языке и установите английский (США). Если новый текст наследует неправильный язык, поместите курсор в этот абзац и измените его язык перед набором текста или выделите и перемаркируйте текст после этого. Слово, которое выглядит как орфографическая ошибка, может быть просто текстом, помеченным неправильным языком.

Проверка орфографии также может быть отключена для выделенного текста или языка. В меню выбора языка Collabora параметр «Нет» исключает выделенный текст из проверки орфографии и переноса. Если текст имеет правильный язык, но не получает знаков орфографии, проверьте состояние проверки орфографии для этого языка и убедитесь, что выделенный текст не исключен из проверки. На странице справки по языкам Collabora описаны варианты языков и параметр «Нет».

Быстрая проверка при отсутствии нужного языка.

В руководстве администратора Nextcloud URL-адрес сервера Collabora описан в разделе конфигурации Office. Держите этот параметр интеграции отдельно от изменения словаря; если соединение уже работало ранее, обычно вам не нужно его менять для языков с проверкой орфографии. Обратитесь к документации по настройке Nextcloud Office .

Проверьте результат в реальном документе.

Создайте или откройте тестовый документ и введите намеренно написанное с орфографической ошибкой слово на каждом из доступных языков. Установите для каждого фрагмента текста нужный язык, затем убедитесь, что проверка орфографии отмечает преднамеренную ошибку. Также введите правильно написанное слово на каждом языке, чтобы убедиться, что оно не обрабатывается как иностранный текст. Повторите процедуру со вторым пользователем, если доступность языков различается в зависимости от учетной записи или документа.

Если проверка языка по-прежнему не удается, сократите количество локалей до одной за раз, проверьте журналы кода и сравните код с документацией для конкретной версии изображения. Список разрешенных слов по умолчанию и содержимое изображений в Collabora могут меняться между выпусками; не следует предполагать, что значения по умолчанию, указанные в руководстве для версии 25.04, будут применяться ко всем последующим тегам. После того, как проверка орфографии заработает в каждом явно помеченном фрагменте текста, сохраните наименьший список языков, который соответствует потребностям ваших пользователей.