Lokalisointi

Integraatio toimittaa käännökset kaikille luoduille entiteettien nimille ja tiloille Home Assistantin standardikäännösjärjestelmän kautta, ja ne tallennetaan custom_components/dreame_vacuum/translations/*.json. Nämä tiedostot toimivat myös perussanakirjana, jota alemmat käyttöliittymät käyttävät oman käyttöliittymänsä tekstien kohdalla.

Käännösten korjaaminen tai parantaminen

Jos kirjoitusvirhe tai virheellinen käännös havaitaan, tai jos uusi kielituki tarvitaan, kontribuutiot menevät tähän arkistoon.

Käännösten yleistys

Virallisessa sovelluksessa käytetään usein eri terminologiaa identtisille parametreille eri laitesukupolvien välillä. Käännöksissä on käytettävä loogisia, yleisiä nimiä sen sijaan, että kopioitaisiin sovelluksen tarkkaa sanamuotoa. Tämä estää käännösristiriitoja, joissa yhden tietyn sukupolven korjaus ylikirjoitetaan myöhemmin käyttäjien toimesta, joilla on eri laitesukupolvi.

Päivitysprosessi sisältää seuraavat vaiheet:

1. Forkkaa varasto: Forkkaa Dreame Vacuum Home Assistant -integraatiovarasto GitHubissa.
2. Etsi käännöstiedosto: Mene forkattuun varastoon custom_components/dreame_vacuum/translations/-hakemistoon löytääksesi käännöstiedoston, joka vastaa kielikoodia, kuten de.json tai it.json.
3. Tee muutokset: Päivitä virheellinen teksti. config-lohko hallitsee asetusten ja vaihtoehtojen tekstien kulkua. entity-lohko hallitsee entiteettien nimeämistä, valintavaihtoehtoja ja niiden tiloja.
4. Lähetä Pull Request: Avaa Pull Request dev-haaraan. Kun Pull Request on tarkistettu ja yhdistetty uuteen julkaisuun, Home Assistant ottaa automaattisesti käyttöön päivitetyt käännökset.

Käyttöliittymän käännökset

Käyttöliittymälle spesifiset käännösavaimet ja jaetut toimintojen etiketit ylläpidetään kielitiedostojen entity_component-lohkossa. Lisätietoja siitä, miten käyttöliittymän käännökset on strukturoitu ja miten alihakujen UI-komponentit käyttävät niitä, löytyy Dreame Vacuum Card -käännösten dokumentaatio.