在 Collabora Online CODE 中啟用多語言拼字檢查

要在 Collabora Online 中對多種語言進行拼字檢查，請將每種所需的語言程式碼新增至 CODE 容器的dictionaries設定中，重啟容器，並為每個文字段落指派正確的語言。伺服器和文件雙方都至關重要：伺服器必須提供相應的字典，並且文件必須用其語言標記英語、法語或其他語言的段落。僅將語言新增至容器並不會自動識別文件中的所有語言。

需要配置哪些內容？

這裡需要考慮兩種不同的設定：

伺服器字典： 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 文件，請編輯現有的 Collabora 服務，而不是建立第二個容器。

以上語言程式碼遵循 Collabora 文件中的程式碼，其中區域設定可以包含國家/地區程式碼。請使用與使用者所需文檔語言相符的程式碼。不要假設每個 CODE 映像中每個可能的程式碼都有可用的字典：SDK 手冊描述如何變更配置列表，但實際可用的內容仍然取決於已安裝的版本及其字典。在新增不太常見的區域設定之前，請查閱您執行的 CODE 鏡像版本的文件。

應用此更改

備份或提交當前的 Compose 文件，以便您可以撤銷變更。
僅更新dictionaries使用者所需的語言值。保留其他 Collabora 環境變數。
重新建立服務，以便 Docker 將更新的環境傳遞給容器。對於 Compose 部署，請docker compose up -d --force-recreate collabora從包含 Compose 檔案的目錄中執行命令。
檢查啟動輸出docker compose logs --tail=100 collabora。尋找啟動或字典載入錯誤；不要僅憑容器狀態成功就斷定某個字典已安裝。

如果您的部署使用的docker run是其他方式，請更新其-e dictionaries="en_US en_GB fr_FR"參數，並使用相同的網路、磁碟區、代理程式和安全性選項重新建立該容器。更改正在運行的容器的環境不會更改其啟動時的環境。

給每段文字指定一種語言

伺服器準備就緒後，在 Nextcloud 中開啟一個文檔，並選擇要檢查語言的文字。在 Collabora 的語言控制中，選擇所選文字或段落的語言；如果文件全部使用同一種語言，則使用將該語言應用於所有文字的選項。不同版本和螢幕佈局的命令標籤可能略有不同，但關鍵在於設定文件文字語言，而不僅僅是更改介面語言。 Collabora 的幫助文件解釋說，文件語言決定了拼字檢查、同義詞庫和斷字所使用的字典。

對於混合語言文檔，請分塊應用語言。例如，先選擇法語段落並設定語言為“法語（法國）”，然後選擇英語段落並設定語言為“英語（美國）”。如果新文字繼承了錯誤的語言，請將遊標放在該段落中，在輸入之前更改其語言，或之後選擇文字並重新標記語言。拼字錯誤的單字可能只是被錯誤標記了語言。

拼字檢查功能也可以針對特定選項或語言停用。在 Collabora 的語言選單中，「無」選項會將選定的文字排除在拼字檢查和斷字之外。如果文字語言正確但未顯示任何拼字標記，請檢查語言的拼字檢查狀態，並確認所選內容是否已被排除。 Collabora語言幫助頁面詳細介紹了語言選項和「無」選項。

快速檢查語言缺失狀況

你所看到的	需要檢查什麼
只有一種語言有拼字符號。	確認所有必需的程式碼都已添加`dictionaries`，重新建立程式碼，然後測試明確標記了每種語言的文字。
選單中包含一種語言，但未選取任何字詞。	將選定段落的語言設定為該語言，並確認拼字檢查已啟用，而不是設定為“無”。選單可用並不能證明字典功能正常。
編輯「撰寫」後，更改無效。	請確認您已重新建立 Collabora 服務，並且正在執行的容器是由已編輯的 Compose 專案管理的容器。
Nextcloud 重建後無法開啟文檔	檢查 Collabora 服務和代理程式日誌，並確認 Nextcloud 的 Office 設定仍然指向 Collabora 伺服器 URL。字典配置無法修復 WOPI 或反向代理連線。

Nextcloud 管理手冊在 Office 設定中描述了 Collabora 伺服器 URL。請將此整合設定與字典變更分開；如果先前連線已正常運作，通常無需變更拼字檢查語言設定。請參閱Nextcloud Office 設定文件。

在真實文件中驗證結果

建立或開啟一個測試文檔，並在每種已啟用的語言中故意輸入一個拼字錯誤的單字。將每個範例段落設定為其目標語言，然後確認拼字檢查是否標記了該故意拼錯的單字。同時，在每種語言中輸入一個拼寫正確的單詞，以確保其不會被識別為外語文字。如果不同帳戶或文件的語言可用性不同，請使用第二個使用者重複上述步驟。

如果某種語言仍然無法識別，請每次只測試一種語言環境，檢查 CODE 日誌，並將程式碼與文件中對應的鏡像版本進行比較。 Collabora 的預設字典允許清單和鏡像內容可能會在不同版本之間發生變化；不應假定 25.04 版本手冊中記錄的預設值適用於所有後續版本。一旦每個明確標記的段落拼字檢查都正常，請保留滿足使用者需求的最小語言清單。