Локализация

Интеграция поставляется с переводами для всех создаваемых названий сущностей и состояний через стандартную систему перевода Home Assistant, которые хранятся в custom_components/dreame_vacuum/translations/*.json. Эти файлы также служат базовым словарем, который используют последующие пользовательские интерфейсы для своего текста интерфейса.

Исправление или улучшение переводов

Если выявлена опечатка или некорректный перевод, либо требуется поддержка нового языка, вклад вносятся в этот репозиторий.

Обобщение переводов

Официальное приложение часто использует разную терминологию для идентичных параметров на разных поколениях устройств. Переводы должны использовать логичные, обобщённые названия, а не строго копировать точные формулировки из приложения. Это предотвращает конфликты перевода, когда исправление, предназначенное для одного конкретного поколения, впоследствии перезаписывается пользователями с другими поколениями устройств.

Процесс обновления включает следующие шаги:

1. Форкнуть репозиторий: Форкаем Репозиторий интеграции Dreame Vacuum Home Assistant на GitHub.
2. Найти файл перевода: Переходим в каталог custom_components/dreame_vacuum/translations/ в форкнутом репозитории, чтобы найти файл перевода, соответствующий коду языка, например de.json или it.json.
3. Внести изменения: Обновляем некорректный текст. Блок config управляет текстами потока конфигурации и потока параметров. Блок entity управляет именами сущностей, опциями выбора и их состояниями.
4. Отправить Pull Request: Открытие Pull Request в ветку dev. После того как Pull Request будет рассмотрен и объединен в новый релиз, Home Assistant автоматически подхватывает обновленные переводы.

Переводы интерфейса

Специфичные для интерфейса ключи переводов и общие метки действий поддерживаются внутри блока entity_component файлов языка. Для получения подробной информации о том, как структурированы переводы интерфейса и используются компонентами интерфейса, см. Документация по переводам карточки пылесоса Dreame.