Lokalizacija

Dreame Vacuum Card nativno podpira več jezikov. Dinamično uporablja jezikovne datoteke, ki jih zagotavlja zaledje, dreame_vacuum integracijo, namesto da bi vzdrževala ločene lokalizacijske datoteke.

Kartica pridobi lokalizirane besedilne vrednosti iz entity_component razdelka znotraj dreame_vacuum Datoteke za prevajanje integracije.

Prevajalski ključi

V jezikovnih datotekah kartica primarno uporablja več kategorij ključev, ki se začnejo z frontend_ za prikaz vmesnika:

• frontend_action: Ta razdelek vsebuje vsa besedila, uporabljena znotraj akcijskih gumbov na glavni nadzorni plošči kartice, kot so Start, Pause ali Dock.

• frontend_config: Ta razdelek vsebuje vse besedilne oznake, opise in nastavitve, uporabljene v uporabniškem vmesniku konfiguratorja vizualnih kartic.

• frontend_message: Vsebuje statusna sporočila, opozorila, poročila o napakah in opozorila, prikazana na kartici.

• frontend_title: Zajema naslove in naslove razdelkov, ki se uporabljajo v menijih kartice, kot so Upravljanje zemljevida ali Nastavitve čiščenja.

• entity: Ta blok zajema Home Assistant entitetne domene, kot so select, sensor, switch, number, time in input. Kartica dinamično pridobiva imena in stanje teh entitet, kot so Nivo sesanja ali Tiho, neposredno iz integracije, da se zagotovi skladnost.

  • Stanja specifična za kartico: Nudi prevode za notranja stanja, ki jih uporablja izključno uporabniški vmesnik kartice, ne pa Home Assistant entitete. To vključuje imena sob (izvedena iz entitete segment_name), skupaj s posebnimi identifikatorji, kot so task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method in recovery_map_type.

Oblikovanje datuma, ure in enot

Poleg besedilnih prevodov se kartica samodejno prilagaja lokalnim preferencam oblikovanja, brez potrebe po ročni konfiguraciji:

• Jezik in lokalne nastavitve: Kartica ima prednost jezika, izbranega v Home Assistant profilu. Če tam ni posebej nastavljenega jezika, samodejno uporabi privzeti jezik spletnega brskalnika.
• 12/24-urni format časa: Kartica upošteva format časa, nastavljen v profilu Home Assistant. Če ni določen, samodejno uporabi standardni časovni format regije naprave.
• Prvi dan v tednu: Kartica neposredno prebere nastavitev prvega dne v tednu iz Home Assistant. Če ni določeno, dinamično določi, ali naj se koledar začne v nedeljo ali ponedeljek glede na lokalno regijo.
• Sistem enot: Kartica nenehno preverja globalno konfiguracijo Home Assistant. Če sistem uporablja imperialni sistem enot, kartica samodejno ponovno izračuna površine in razdalje ter jih prikazuje naravno v stopalih, kvadratnih stopalih ali jardih.
• Prevodi domačih enot: Pogoste enote in okrajšave, kot so meter, kilometer, foot, yard, minute in hour, ne zahtevajo ročnega prevajanja. Kartica jih prevaja sproti z uporabo vgrajenih funkcij brskalnika, ki so posebej prilagojene za aktivni jezik.

Popravi ali izboljšaj prevode

Če je zaznana tipkarska napaka ali napačen prevod, ali če je potrebna podpora za nov jezik, prispevki gredo v glavni dreame_vacuum repozitorij integracije.

Generalizacija prevodov

Uradna aplikacija pogosto uporablja različne termine za enake parametre v različnih generacijah naprav. Prevodi morajo uporabljati logična, posplošena imena, namesto da bi natančno kopirali besedilo iz aplikacije. To preprečuje konflikte pri prevodih, kjer bi popravek, prilagojen eni specifični generaciji, kasneje prepisali uporabniki z drugimi generacijami naprav.

Postopek posodobitve vključuje naslednje korake:

1. Razvejite repozitorij: Razveitev repozitorija Dreame Vacuum Home Assistant integracije na GitHubu.
2. Poiščite datoteko s prevodom: Pomik v custom_components/dreame_vacuum/translations/ imenik v razvejenem repozitoriju, da najdete datoteko s prevodom, ki ustreza jezikovni kodi, kot je de.json ali it.json.
3. Naredite spremembe: Posodabljanje napačnega besedila. Bloki frontend_action, frontend_config, frontend_message in frontend_title upravljajo besedilo, povezano z uporabniškim vmesnikom. Blok entity upravlja imena senzorjev, možnosti izbire in njihove stanje.
4. Pošljite zahtevo za združitev: Odprtje Pull Requesta v glavni repozitorij. Ko je Pull Request pregledan in združen v novo izdajo integracije, Dreame Vacuum Card samodejno prevzame posodobljene prevode.