Локалізація

Картка Dreame Vacuum нативно підтримує кілька мов. Вона динамічно використовує мовні файли, надані інтеграцією бекенду dreame_vacuum, замість того, щоб підтримувати окремі файли локалізації.

Картка отримує локалізовані текстові значення з розділу entity_component у dreame_vacuum файли перекладу інтеграції.

Ключі перекладу

У мовних файлах картка головним чином використовує кілька категорій ключів, що починаються з frontend_, для відображення свого інтерфейсу:

• frontend_action: Цей розділ містить усі тексти, що використовуються всередині кнопок дій на головній панелі керування картки, таких як Пуск, Пауза або Док.

• frontend_config: Цей розділ містить усі текстові підписи, описи та налаштування, що використовуються всередині візуального конфігуратора картки.

• frontend_message: Містить повідомлення про стан, сповіщення, звіти про помилки та попередження, що відображаються на картці.

• frontend_title: Охоплює заголовки та назви розділів, що використовуються у меню картки, таких як Управління картою або Налаштування прибирання.

• entity: Цей блок охоплює домени сутностей Home Assistant, такі як select, sensor, switch, number, time та input. Картка динамічно отримує імена та стани цих сутностей, такі як Рівень всмоктування або Тихо, безпосередньо з інтеграції, щоб забезпечити узгодженість.

  • Стан карти: Надає переклади для внутрішніх станів, які використовуються виключно в інтерфейсі картки, а не сутностями Home Assistant. Це включає назви кімнат (отримані з сутності segment_name), а також конкретні ідентифікатори, такі як task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method та recovery_map_type.

Форматування дати, часу та одиниць

Окрім текстових перекладів, картка автоматично підлаштовується під місцеві налаштування форматування без необхідності ручної конфігурації:

• Мова та локаль: Картка віддає перевагу мові, обраній у профілі Home Assistant. Якщо там мова явно не встановлена, вона автоматично використовує мову веб-браузера за замовчуванням.
• 12/24-годинний формат часу: Картка враховує формат часу, налаштований у профілі Home Assistant. Якщо не задано, вона автоматично приймає стандартний формат часу для регіону пристрою.
• Перший день тижня: Картка читає налаштування першого дня тижня безпосередньо з Home Assistant. Якщо не визначено, вона динамічно визначає, чи слід починати календар із неділі чи понеділка, залежно від локального регіону.
• Система одиниць: Картка постійно перевіряє глобальні налаштування Home Assistant. Якщо система використовує імперську систему одиниць, картка автоматично перераховує площі та відстані, відображаючи їх у футах, квадратних футах або ярдах.
• Переклади рідних одиниць: Загальновживані суфікси та скорочення одиниць, такі як метр, кілометр, фут, ярд, хвилина та година, не потребують ручного перекладу. Картка перекладає їх автоматично за допомогою вбудованих функцій браузера, спеціально налаштованих для активної мови.

Виправити або покращити переклади

Якщо виявлено опечатку або неправильний переклад, або потрібна підтримка нової мови, внески надсилаються у головний dreame_vacuum репозиторій інтеграції.

Узагальнення перекладу

Офіційний додаток часто використовує різну термінологію для однакових параметрів у різних поколіннях пристроїв. Переклади повинні використовувати логічні, узагальнені назви, а не безпосередньо копіювати точний текст із APP. Це запобігає конфліктам перекладу, коли виправлення, призначене для одного конкретного покоління, пізніше перезаписується користувачами з іншими поколіннями пристроїв.

Процес оновлення включає наступні кроки:

1. Форкніть репозиторій: Форкування репозиторію інтеграції Dreame Vacuum для Home Assistant на GitHub.
2. Знайдіть файл перекладу: Перейдіть до custom_components/dreame_vacuum/translations/ директорії у форкнутому репозиторії, щоб знайти файл перекладу, який відповідає коду мови, наприклад de.json або it.json.
3. Зробіть зміни: Оновлення неправильного тексту. Блоки frontend_action, frontend_config, frontend_message і frontend_title керують текстом, що відображається в інтерфейсі користувача. Блок entity керує іменами сенсорів, опціями вибору та їх станами.
4. Надішліть Pull Request: Відкрийте Pull Request до основного репозиторію. Після того як Pull Request буде розглянутий і об'єднаний у нову версію інтеграції, Dreame Vacuum Card автоматично отримає оновлені переклади.