本地化
该集成通过 Home Assistant 的标准翻译系统为所有生成的实体名称和状态提供翻译,这些翻译存储在 custom_components/dreame_vacuum/translations/*.json 中。这些文件也用作下游用户界面用于自身界面文本的基础字典。
修复或改进翻译
如果发现拼写错误或翻译不正确,或者需要支持新语言,可以将贡献提交到该仓库。
翻译概述
官方应用程序在不同设备代之间经常对相同的参数使用不同的术语。翻译必须使用合乎逻辑的通用名称,而不是严格复制应用中的原始文本。这可以防止针对某一特定代的修正被使用不同设备代的用户覆盖造成的翻译冲突。
更新流程包括以下步骤:
- Fork 仓库:在 GitHub 上 Fork Dreame 吸尘器 Home Assistant 集成仓库。
- 找到翻译文件:导航到 fork 后的仓库中的
custom_components/dreame_vacuum/translations/目录,找到与语言代码匹配的翻译文件,例如de.json或it.json。 - 进行修改:更新错误文本。
config块管理配置流程和选项流程文本。entity块管理实体名称、选择选项及其状态。 - 提交拉取请求:向
dev分支打开拉取请求。拉取请求在审核并合并到新版本后,Home Assistant 会自动获取更新的翻译。
前端翻译
前端特定的翻译键和共享操作标签在语言文件的 entity_component 块中维护。有关前端翻译如何结构化以及下游 UI 组件如何使用的详细信息,请参考 Dreame 吸尘器卡片翻译文档。