Lokalizacija

Dreame Vacuum Card izvorno podržava više jezika. Dinamički koristi jezične datoteke koje pruža backend dreame_vacuum integracija, umjesto da održava zasebne lokalizacijske datoteke.

Kartica dohvaća lokalizirane tekstualne vrijednosti iz entity_component sekcije unutar dreame_vacuum datoteke za prijevod integracije.

Ključevi prijevoda

Unutar jezičnih datoteka, kartica prvenstveno koristi nekoliko kategorija ključeva koje počinju s frontend_ za prikaz svog sučelja:

• frontend_action: Ova sekcija sadrži sav tekst koji se koristi unutar akcijskih tipki na glavnoj kontrolnoj ploči kartice, kao što su Start, Pauza, ili Pristanište.

• frontend_config: Ova sekcija sadrži sve tekstualne oznake, opise i postavke koje se koriste unutar vizualnog konfiguratora kartice UI.

• frontend_message: Sadrži statusne poruke, upozorenja, izvještaje o pogreškama i upozorenja prikazana na kartici.

• frontend_title: Obuhvaća naslove i nazive sekcija koji se koriste unutar izbornika kartice, kao što su Upravljanje kartom ili Postavke čišćenja.

• entity: Ovaj blok pokriva Home Assistant entitetske domene poput select, sensor, switch, number, time i input. Kartica dinamički dohvaća imena i stanja tih entiteta, poput Razina usisavanja ili Tihi, iz same integracije kako bi se osigurala konzistentnost.

  • Specifična stanja kartice: Pruža prijevode za unutarnja stanja koja se koriste isključivo u korisničkom sučelju kartice, a ne kod Home Assistant entiteta. Ovo uključuje nazive soba (izvedene iz segment_name entiteta), zajedno s određenim identifikatorima poput 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.

Formatiranje datuma, vremena i jedinica

Osim prijevoda teksta, kartica se automatski prilagođava lokalnim postavkama formata bez potrebe za ručnom konfiguracijom:

• Jezik i lokalne postavke: Kartica daje prednost jeziku odabranom u Home Assistant profilu. Ako tamo nije eksplicitno postavljen jezik, automatski se koristi zadani jezik web preglednika.
• 12/24-satni format vremena: Kartica poštuje format vremena konfiguriran u profilu Home Assistanta. Ako nije specificirano, automatski prihvaća standardni format vremena regije uređaja.
• Prvi dan u tjednu: Kartica očitava postavku prvog dana u tjednu izravno iz Home Assistanta. Ako nije definiran, dinamički određuje hoće li kalendar početi u nedjelju ili ponedjeljak na temelju lokalne regije.
• Sustav mjernih jedinica: Kartica kontinuirano provjerava globalnu konfiguraciju Home Assistanta. Ako sustav koristi imperijalni sustav mjernih jedinica, kartica automatski preračunava površine i udaljenosti, prikazujući ih nativno u stopama, kvadratnim stopama ili jardima.
• Prijevodi nativnih jedinica: Uobičajeni sufiksi i skraćenice jedinica, kao što su metar, kilometar, stopa, yard, minuta i sat, ne zahtijevaju ručni prijevod. Kartica ih prevodi automatski koristeći ugrađene značajke preglednika prilagođene aktivnom jeziku.

Popravite ili poboljšajte prijevode

Ako se otkrije tipografska pogreška ili netočan prijevod, ili je potrebna podrška za novi jezik, doprinosi idu u glavni dreame_vacuum repozitorij integracije.

Generalizacija prijevoda

Službena aplikacija često koristi različitu terminologiju za identične parametre u različitim generacijama uređaja. Prijevodi moraju koristiti logična, generalizirana imena umjesto da strogo kopiraju točan tekst iz APLIKACIJE. To sprječava sukobe u prijevodu gdje ispravak namijenjen jednoj specifičnoj generaciji postupno biva prepisan od strane korisnika s različitim generacijama uređaja.

Proces ažuriranja uključuje sljedeće korake:

1. Napravite fork spremišta: Napravite fork Dreame Vacuum Home Assistant integracijskog spremišta na GitHubu.
2. Pronađite datoteku za prijevod: Navigacija do custom_components/dreame_vacuum/translations/ direktorija u forkiranom spremištu kako biste pronašli datoteku za prijevod koja odgovara jezičnom kodu, poput de.json ili it.json.
3. Napravite izmjene: Ažuriranje netočnog teksta. Blokovi frontend_action, frontend_config, frontend_message i frontend_title upravljaju tekstom vezanim za korisničko sučelje. Blok entity upravlja imenima senzora, opcijama za odabir i njihovim stanjima.
4. Pošaljite Pull Request: Otvorite Pull Request prema glavnom spremištu. Nakon što se Pull Request pregledava i spoji u novo izdanje integracije, Dreame Vacuum Card automatski preuzima ažurirane prijevode.