Collabora Online CODEで多言語スペルチェックを有効にする

Collabora Onlineで複数の言語のスペルチェックを行うには、必要な言語コードをそれぞれCODEコンテナのdictionaries設定に追加し、コンテナを再起動して、各テキストに適切な言語を割り当てます。サーバー側とドキュメント側の両方が重要です。サーバー側で辞書を利用できるようにする必要があるだけでなく、ドキュメント側でも英語、フランス語、またはその他の言語をそれぞれの言語でマークする必要があります。コンテナに言語を追加するだけでは、ドキュメント内のすべての言語が自動的に識別されるわけではありません。

何を設定する必要がありますか？

考慮すべき設定は2つあります。

サーバー辞書： CODE Dockerイメージは、デフォルトで限定された辞書リストを有効にします。dictionaries環境変数によって、CODEが設定する辞書言語のリストを変更できます。Collaboraの25.04 SDKマニュアルには、スペースで区切られた言語コード（オプションで国コードが続く）が記載されており、リストを制限することで不要なリソースの使用や起動作業を回避できると説明されています。
文書言語： Collaboraは、テキストに割り当てられた言語を使用してスペル辞書を選択します。文書には、異なる選択範囲や段落で異なる言語が含まれる可能性があるため、各箇所に適切なタグ付けを行う必要があります。

例えば、英語（米国）とフランス語の文章を含む文書の場合、サーバー側で両方の言語コードを有効にする必要があり、英語とフランス語のテキストにはそれぞれ対応する言語設定が必要です。ユーザーインターフェースの言語やキーボードレイアウトは、これらの設定の代わりにはなりません。詳細については、Collabora Online 25.04 SDK マニュアルおよび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ファイルを使用している場合は、2つ目のコンテナを作成するのではなく、既存のCollaboraサービスを編集してください。

上記の言語コードは、Collabora が文書化したコードに準拠しており、ロケールには国コードを含めることができます。ユーザーが必要とするドキュメント言語に一致するコードを使用してください。すべての CODE イメージに、使用可能な辞書が必ず存在するとは限りません。SDK マニュアルでは、構成リストの変更について説明していますが、実際に使用可能な言語は、インストールされているビルドとその辞書によって決まります。あまり一般的でないロケールを追加する前に、実行している CODE イメージのバージョンに関するドキュメントを確認してください。

変更を適用する

変更を元に戻せるように、現在のComposeファイルをバックアップまたはコミットしてください。
dictionariesユーザーが必要とする言語のみで値を更新してください。その他のCollabora環境変数はそのまま保持してください。
サービスを再作成して、Docker が更新された環境をコンテナに渡すようにします。Compose デプロイメントの場合は、docker compose up -d --force-recreate collaboraCompose ファイルを含むディレクトリから実行してください。
起動時の出力を確認してくださいdocker compose logs --tail=100 collabora。起動エラーや辞書読み込みエラーを探してください。コンテナの状態が正常であるからといって、特定の辞書がインストールされていると断定しないでください。

デプロイメントdocker runで代わりにを使用している場合は、-e dictionaries="en_US en_GB fr_FR"引数を更新し、同じネットワーク、ボリューム、プロキシ、およびセキュリティオプションを使用してコンテナを再作成してください。実行中のコンテナの環境を変更しても、起動時の環境は変更されません。

各文章に言語を割り当てる

サーバーの準備ができたら、Nextcloudでドキュメントを開き、言語チェックを行うテキストを選択します。Collaboraの言語設定で、選択範囲または段落の言語を選択します。ドキュメント全体が同じ言語の場合は、すべてのテキストに言語を適用するオプションを使用します。コマンドのラベルはリリースや画面レイアウトによって若干異なる場合がありますが、重要なのはインターフェース言語を変更するだけでなく、ドキュメントのテキスト言語を設定することです。Collaboraのヘルプには、ドキュメントの言語によってスペルチェック、類語辞典、ハイフネーションに使用される辞書が決まる、と説明されています。

複数の言語が混在する文書の場合は、言語を部分ごとに適用してください。たとえば、フランス語の段落を選択して「フランス語（フランス）」に設定し、次に英語の段落を選択して「英語（米国）」に設定します。新しいテキストが誤った言語を引き継いでしまった場合は、カーソルをその段落に置いて入力前に言語を変更するか、入力後にテキストを選択して再度タグ付けしてください。スペルミスのように見える単語は、単に誤った言語でマークされたテキストである可能性があります。

選択範囲や言語によっては、スペルチェックを無効にすることもできます。Collaboraの言語メニューで「なし」を選択すると、選択したテキストがスペルチェックとハイフネーションの対象から除外されます。テキストの言語が正しいにもかかわらずスペルチェックマークが表示されない場合は、その言語のスペルチェック設定を確認し、選択範囲が除外されていないか確認してください。Collaboraの言語ヘルプページでは、言語の選択肢と「なし」オプションについて説明しています。

言語が欠落している場合のクイックチェック

表示されているもの	確認すべき事項
スペルチェックマークが付くのは1つの言語のみ	必要なコードがすべて含まれていることを確認し`dictionaries`、CODE を再作成してから、各言語で明示的にタグ付けされたテキストをテストします。
メニューには言語が表示されますが、単語はチェックされていません。	選択した文章をその言語に設定し、スペルチェックが「なし」ではなく「有効」になっていることを確認してください。メニューに表示されているだけでは、辞書が正常に機能しているとは言えません。
変更内容は編集後に反映されません	Collaboraサービスを再作成したこと、および実行中のコンテナが編集したComposeプロジェクトによって管理されているコンテナであることを確認してください。
Nextcloud は再作成後にドキュメントを開くことができません	Collaboraサービスとプロキシのログを確認し、NextcloudのOffice設定が引き続きCollaboraサーバーのURLを指していることを確認してください。辞書の設定では、WOPIまたはリバースプロキシ接続は修復されません。

Nextcloud の管理マニュアルでは、Office 設定の項目に Collabora サーバーの URL が記載されています。この統合設定は辞書の変更とは別に管理してください。以前に接続が正常に機能していた場合は、通常、スペルチェック言語のために設定を変更する必要はありません。Nextcloud Office 設定に関するドキュメントを参照してください。

実際の文書で結果を確認する

テスト文書を作成または開き、有効になっている各言語で意図的にスペルミスのある単語を入力します。各サンプル文を目的の言語に設定し、スペルチェックで意図的なエラーがマークされることを確認します。また、各言語で正しいスペルの単語を入力して、外国語テキストとして扱われていないことを確認します。アカウントまたは文書によって言語の利用可否が異なる場合は、別のユーザーで同じ手順を繰り返してください。

言語によってはテストが失敗する場合があります。その場合は、テスト対象を一度に1つのロケールに絞り込み、CODEログを確認し、コードを該当イメージバージョンのドキュメントと比較してください。Collaboraのデフォルトの辞書許可リストとイメージの内容はリリースごとに変更される可能性があるため、25.04マニュアルに記載されているデフォルト設定を以降のすべてのタグに適用できるとは限りません。明示的にタグ付けされた各パッセージでスペルチェックが正常に機能するようになったら、ユーザーのニーズを満たす最小限の言語リストを保持してください。