Skip to content

本地化 ​

該整合會透過 Home Assistant 的標準翻譯系統,為所有生成的實體名稱和狀態提供翻譯,並儲存在 custom_components/dreame_vacuum/translations/*.json 中。這些檔案同時也是下游使用者介面用來建立自身介面文字的基本詞典。

修正或改進翻譯 ​

如果發現拼寫錯誤或翻譯不正確,或需要支援新的語言,可以將貢獻提交到此存放庫。

翻譯通用化

官方應用程式經常在不同設備世代中對相同參數使用不同術語。翻譯時必須使用合乎邏輯、概括性的名稱,而不是嚴格複製應用程式中的原文。這可以避免翻譯衝突,例如為某個特定世代做出的修正,會被其他設備世代的用戶覆蓋。

更新流程包括以下步驟:

  1. Fork 倉庫:在 GitHub 上叉出 Dreame 吸塵器 Home Assistant 整合倉庫。
  2. 找到翻譯文件:導航到叉出的倉庫中的 custom_components/dreame_vacuum/translations/ 目錄,尋找與語言代碼對應的翻譯文件,例如 de.json 或 it.json。
  3. 進行修改:更新錯誤的文本。config 區塊管理配置流程及選項流程的文本。entity 區塊管理實體名稱、選項以及其狀態。
  4. 提交拉取請求:對 dev 分支開啟拉取請求。拉取請求經審查並合併到新版本後,Home Assistant 會自動抓取更新的翻譯。

前端翻譯

前端專用的翻譯鍵和共享操作標籤維護在語言文件的 entity_component 區塊中。關於前端翻譯的結構以及下游 UI 組件如何使用的詳細資訊,請參考 Dreame 吸塵器卡片翻譯文件。