Skip to content

Localizare ​

Cardul Dreame Vacuum suportă în mod nativ mai multe limbi. Acesta folosește dinamic fișierele de limbă furnizate de integrarea backend dreame_vacuum în loc să mențină fișiere de localizare separate.

Cardul preia valorile textelor localizate din secțiunea entity_component din cadrul dreame_vacuum fișiere de traducere ale integrării.

Chei de traducere ​

În cadrul fișierelor de limbă, cardul folosește în principal mai multe categorii de chei care încep cu frontend_ pentru a afișa interfața sa:

  • frontend_action: Această secțiune conține tot textul utilizat în interiorul butoanelor de acțiune de pe panoul principal de control al cardului, cum ar fi Start, Pause sau Dock.

  • frontend_config: Această secțiune conține toate etichetele de text, descrierile și setările utilizate în interiorul interfeței vizuale de configurare a cardului.

  • frontend_message: Conține mesaje de stare, alerte, rapoarte de erori și avertismente afișate pe card.

  • frontend_title: Acoperă titlurile și titlurile de secțiune utilizate în meniurile cardului, cum ar fi Map Management sau Cleaning Settings.

  • entity: Acest bloc acoperă domenii de entități Home Assistant, cum ar fi select, sensor, switch, number, time și input. Cardul preia dinamic numele și stările acestor entități, cum ar fi Nivel de Aspirație sau Silence, direct din integrare pentru a asigura consistența.

    • Stări Specifice Cardului: Oferă traduceri pentru stările interne folosite exclusiv de interfața cardului, mai degrabă decât de entitățile Home Assistant. Aceasta include numele camerelor (derivate din entitatea segment_name), împreună cu identificatori specifici precum task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method și recovery_map_type.

Formatarea Datei, Orei și Unităților ​

Pe lângă traducerea textelor, cardul se adaptează automat la preferințele locale de formatare fără a necesita configurare manuală:

  • Limbă & Localizare: Cardul prioritizează limba selectată în profilul Home Assistant. Dacă nicio limbă nu este setată în mod explicit acolo, se revine automat la limba implicită a browserului web.
  • Format orar 12/24 de ore: Cardul respectă formatul orar configurat în profilul Home Assistant. Dacă nu este specificat, adoptă automat formatul orar standard al regiunii dispozitivului.
  • Prima zi a săptămânii: Cardul preia setarea primei zile a săptămânii direct din Home Assistant. Dacă nu este definită, determină dinamic dacă calendarul ar trebui să înceapă duminica sau lunea, în funcție de regiunea locală.
  • Sistem de unități: Cardul verifică continuu configurația globală din Home Assistant. Dacă sistemul folosește sistemul de unități imperial, cardul recalculează automat suprafețele și distanțele, afișându-le nativ în picioare, picioare pătrate sau yarzi.
  • Traduceri Unități Native: Sufixe și abreviaturi comune ale unităților, cum ar fi metru, kilometru, picior, yard, minut și oră, nu necesită nicio traducere manuală. Cardul le traduce automat folosind funcțiile încorporate ale browserului, adaptate special pentru limba activă.

Corectează sau îmbunătățește traducerile ​

Dacă se identifică o greșeală de tipar sau o traducere incorectă, sau este nevoie de suport pentru o limbă nouă, contribuțiile se fac în principalul dreame_vacuum depozit de integrare.

Generalizarea traducerii

Aplicația oficială folosește frecvent termeni diferiți pentru parametri identici pe diferite generații de dispozitive. Traducerile trebuie să utilizeze nume logice și generalizate, mai degrabă decât să copieze strict formulările exacte din aplicație. Acest lucru previne conflictele de traducere, unde o corecție destinată unei generații specifice este ulterior suprascrisă de utilizatori cu generații diferite de dispozitive.

Procesul de actualizare implică următorii pași:

  1. Furcați Repozitoriul: Furcarea repozitoriului de integrare Dreame Vacuum Home Assistant pe GitHub.
  2. Găsiți Fișierul de Traducere: Navigarea către directorul custom_components/dreame_vacuum/translations/ din repozitoriul furcat pentru a localiza fișierul de traducere care corespunde codului de limbă, cum ar fi de.json sau it.json.
  3. Faceți Modificările: Actualizarea textului incorect. Blocurile frontend_action, frontend_config, frontend_message și frontend_title gestionează textul legat de interfața utilizatorului. Blocul entity gestionează numele senzorilor, opțiunile de selectare și stările acestora.
  4. Trimiteți un Pull Request: Deschiderea unui Pull Request către repozitoriul principal. După ce Pull Request-ul este revizuit și integrat într-o nouă versiune a integrării, Dreame Vacuum Card preia automat traducerile actualizate.