Локалізація

Інтеграція постачає переклади для всіх згенерованих назв сутностей та станів через стандартну систему перекладів 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 блоці мовних файлів. Для детальної інформації про структуру перекладів інтерфейсу та їх використання компонентами UI, дивись Документація перекладів картки Dreame Vacuum.