Lokalizacija

Dreame Vacuum kortelė natūraliai palaiko kelias kalbas. Ji dinamiškai naudoja kalbos failus, pateikiamus per backend dreame_vacuum integraciją, vietoje atskirų lokalizacijos failų palaikymo.

Kortelė gauna lokalizuotas teksto reikšmes iš entity_component skilties dreame_vacuum integracijos vertimo failai viduje.

Vertimo Raktai

Kalbos failuose kortelė daugiausia naudoja kelias pagrindines raktų kategorijas, prasidedančias frontend_, norėdama rodyti savo sąsają:

• frontend_action: Šioje skiltyje yra visas tekstas, naudojamas veiksmo mygtukuose pagrindiniame kortelės valdymo skydelyje, pvz.: Pradėti, Pauzė ar Dock.

• frontend_config: Šioje skiltyje yra visi tekstiniai žymenys, aprašymai ir nustatymai, naudojami vizualioje kortelės konfigūracijos sąsajoje.

• frontend_message: Apima būsenos pranešimus, perspėjimus, klaidų ataskaitas ir įspėjimus, rodomus kortelėje.

• frontend_title: Apima antraštes ir skilties pavadinimus, naudojamus kortelės meniuose, pvz.: Žemėlapio valdymas arba Valymo nustatymai.

• entity: Šis blokas apima „Home Assistant“ objektų domenus, tokius kaip select, sensor, switch, number, time ir input. Kortelė dinamiškai pateikia šių objektų pavadinimus ir būsenas, pavyzdžiui, Siurbimo lygis arba Tyli, tiesiogiai iš integracijos, kad būtų užtikrintas nuoseklumas.

  • Kortelės specifinės būsenos: Teikia vertimus vidinėms būsenoms, naudojamoms tik kortelės sąsajoje, o ne „Home Assistant“ objektuose. Tai apima kambarių pavadinimus (kylančius iš segment_name objekto), kartu su konkrečiais identifikatoriais, tokiais kaip task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method ir recovery_map_type.

Datos, laiko ir vienetų formatavimas

Be teksto vertimų, kortelė automatiškai prisitaiko prie vietinių formatavimo nuostatų, nereikalaujant jokios rankinės konfigūracijos:

• Kalba ir lokalė: Kortelė pirmenybę teikia kalbai, pasirinktai „Home Assistant“ profilyje. Jei ten aiškiai nėra nustatyta kalba, ji automatiškai grįžta prie numatytosios naršyklės kalbos.
• 12/24 valandų laiko formatas: Kortelė atsižvelgia į Home Assistant profilyje sukonfigūruotą laiko formatą. Jei nenurodytas, ji automatiškai priima įrenginio regiono standartinį laiko formatą.
• Savaitės pirmoji diena: Kortelė skaito savaitės pirmos dienos nustatymą tiesiogiai iš Home Assistant. Jei jis nenurodytas, kortelė dinamiškai nustato, ar kalendorius turėtų prasidėti sekmadienį ar pirmadienį, atsižvelgiant į vietinį regioną.
• Vienetų sistema: Kortelė nuolat tikrina Home Assistant globalią konfigūraciją. Jei sistema naudoja imperinę vienetų sistemą, kortelė automatiškai perskaičiuoja plotus ir atstumus, natūraliai juos rodydama pėdomis, kvadratinėmis pėdomis arba jardais.
• Gimtojo vieneto vertimai: Įprasti vienetų priesagos ir sutrumpinimai, tokie kaip metras, kilometras, pėda, yardas, minutė ir valanda, nereikalauja jokių rankinių vertimų. Kortelė juos verčia automatiškai, naudodama naršyklės įmontuotas funkcijas, pritaikytas konkrečiai aktyviai kalbai.

Pataisyti arba patobulinti vertimus

Jei identifikuojama rašybos klaida ar neteisingas vertimas, arba reikia naujos kalbos palaikymo, indėlis siunčiamas į pagrindinį dreame_vacuum integracijos saugyklą.

Vertimo generalizavimas

Oficialioje programėlėje dažnai naudojami skirtingi terminai identiškiems parametrams skirtingų įrenginių kartų. Vertimai turi naudoti logiškus, apibendrintus pavadinimus, vietoj to, kad griežtai kopijuotų tikslų APP žodyną. Tai apsaugo nuo vertimo konfliktų, kai pataisa skirta konkrečiai kartai vėliau yra perrašoma vartotojų su skirtingomis įrenginių kartomis.

Atnaujinimo procesas apima šiuos veiksmus:

1. Šakoti Saugyklą: Šakoti Dreame Vacuum Home Assistant integracijos saugyklą GitHub.
2. Rasti Vertimo Failą: Eiti į custom_components/dreame_vacuum/translations/ katalogą šakoje saugyklos, kad surastumėte vertimo failą, atitinkantį kalbos kodą, pavyzdžiui, de.json arba it.json.
3. Atlikti Pakeitimus: Atnaujinti neteisingą tekstą. frontend_action, frontend_config, frontend_message ir frontend_title blokai valdo su vartotojo sąsaja susijusį tekstą. entity blokas valdo jutiklių pavadinimus, pasirinkimų opcijas ir jų būsenas.
4. Pateikti Pull Request: Atidaryti Pull Request pagrindinėje saugykloje. Kai Pull Request bus peržiūrėtas ir sujungtas į naują integracijos versiją, Dreame Vacuum kortelė automatiškai pasiims atnaujintus vertimus.