Lokalisointi

Dreame Vacuum -kortti tukee natiivisti useita kieliä. Se käyttää dynaamisesti taustajärjestelmän dreame_vacuum tarjoamia kielitiedostoja sen sijaan, että ylläpidettäisiin erillisiä lokalisaatiotiedostoja.

Kortti hakee lokalisoidut tekstiarvot entity_component-osiosta dreame_vacuum integraation käännöstiedostot-kohdassa.

Käännösavaimet

Kielitiedostojen sisällä kortti käyttää ensisijaisesti useita avainkategorioita, jotka alkavat frontend_:lla, näyttääkseen käyttöliittymänsä:

• frontend_action: Tämä osio sisältää kaikki tekstit, joita käytetään toimintonapeissa kortin pääohjauspaneelissa, kuten Aloita, Tauko tai Telakka.

• frontend_config: Tämä osio sisältää kaikki tekstinimet, kuvaukset ja asetukset, joita käytetään visuaalisessa kortin konfiguraattorin käyttöliittymässä.

• frontend_message: Sisältää tilaviestit, hälytykset, virheraportit ja varoitukset, jotka näytetään kortilla.

• frontend_title: Kattaa otsikot ja osioiden nimet, joita käytetään kortin valikoissa, kuten Karttahallinta tai Siivousasetukset.

• entity: Tämä lohko kattaa Home Assistant -entiteettialueet, kuten select, sensor, switch, number, time ja input. Kortti hakee dynaamisesti näiden entiteettien nimet ja tilat, kuten Imuteho tai Hiljainen, suoraan integraatiosta varmistaakseen yhdenmukaisuuden.

  • Korttiin liittyvät tilat: Tarjoaa käännöksiä kortin käyttöliittymässä yksinomaan käytetyille sisäisille tiloille, eikä Home Assistant -entiteeteille. Tämä sisältää huoneiden nimet (perustuen segment_name entiteettiin), sekä tietyt tunnisteet kuten task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method ja recovery_map_type.

Päivämäärän, ajan ja yksiköiden muotoilu

Tekstikäännösten lisäksi kortti mukautuu automaattisesti paikallisiin muotoiluasetuksiin ilman manuaalista konfigurointia:

• Kieli ja alue: Kortti priorisoi Home Assistant -profiilissa valitun kielen. Jos siellä ei ole erikseen asetettua kieltä, kortti käyttää automaattisesti web-selaimen oletuskieltä.
• 12/24 tunnin aikamuoto: Kortti noudattaa Home Assistant -profiilissa määritettyä aikamuotoa. Jos sitä ei ole määritetty, se ottaa automaattisesti käyttöön laitteen alueen vakio-aikamuodon.
• Viikon ensimmäinen päivä: Kortti lukee viikon ensimmäisen päivän asetuksen suoraan Home Assistantista. Jos sitä ei ole määritelty, se määrittää dynaamisesti, alkaako kalenteri sunnuntaista vai maanantaista paikallisen alueen perusteella.
• Mittayksiköt: Kortti tarkistaa jatkuvasti Home Assistantin yleisasetukset. Jos järjestelmä käyttää imperiaalisia yksiköitä, kortti laskee alueet ja etäisyydet automaattisesti uudelleen ja näyttää ne natiivisti jaloissa, neliöjaloissa tai jaardissa.
• Natiiviyksiköiden käännökset: Yleisiä yksikköpäätteitä ja lyhenteitä, kuten metri, kilometri, jalka, jaardi, minuutti ja tunti, ei tarvitse kääntää manuaalisesti. Kortti kääntää ne lennossa käyttämällä selainominaisuuksia, jotka on erityisesti räätälöity aktiiviselle kielelle.

Korjaa tai paranna käännöksiä

Jos kirjoitusvirhe tai virheellinen käännös havaitaan, tai jos uusi kieli tarvitsee tukea, kontribuutiot menevät pääasialliselle dreame_vacuum-integraatiovarastolle.

Käännösten yleistys

Virallinen sovellus käyttää usein eri terminologiaa identtisille parametreille eri laitesukupolvien välillä. Käännösten tulee käyttää loogisia, yleisiä nimiä sen sijaan, että kopioidaan tarkasti APPin sanamuotoa. Tämä estää käännösristiriidat, joissa yhden tietyn sukupolven korjauksesta tulee myöhemmin ylikirjoitus käyttäjien eri sukupolvien laitteilla.

Päivitysprosessi sisältää seuraavat vaiheet:

1. Haarauta repositorio: Haarauttamalla Dreame Vacuum Home Assistant -integraatiorepository GitHubissa.
2. Etsi käännöstiedosto: Siirtymällä custom_components/dreame_vacuum/translations/-hakemistoon haarautetussa repositoriossa löytääksesi käännöstiedoston, joka vastaa kielikoodia, kuten de.json tai it.json.
3. Tee muutokset: Päivittämällä virheellinen teksti. frontend_action, frontend_config, frontend_message ja frontend_title -lohkot hallitsevat käyttöliittymään liittyvää tekstiä. entity-lohko hallitsee sensorien nimiä, valintavaihtoehtoja ja niiden tiloja.
4. Lähetä Pull Request: Avaamalla Pull Requestin päärepositoryyn. Kun Pull Request on tarkistettu ja yhdistetty uuden integraation version julkaisuun, Dreame Vacuum Card ottaa automaattisesti käyttöön päivitetyt käännökset.