Lokalisering

Dreame Vacuum-kortet støtter flere språk som standard. Det bruker dynamisk språkfilene som tilbys av backend-dreame_vacuum-integrasjonen i stedet for å vedlikeholde separate lokaliseringsfiler.

Kortet henter lokaliserte tekstverdier fra entity_component-delen i dreame_vacuum integrasjon oversettelsesfiler.

Oversettelsesnøkler

Innenfor språkfilene bruker kortet primært flere nøkkelkategorier som starter med frontend_ for å vise grensesnittet sitt:

• frontend_action: Denne delen inneholder all tekst som brukes inne i handlingsknappene på kortets hovedkontrollpanel, som Start, Pause eller Dock.

• frontend_config: Denne delen inneholder alle tekstetiketter, beskrivelser og innstillinger som brukes inne i den visuelle kortkonfiguratoren.

• frontend_message: Inneholder statusmeldinger, varsler, feilmeldinger og advarsler som vises på kortet.

• frontend_title: Dekker overskrifter og seksjonstitler som brukes i kortets menyer, slik som Kartadministrasjon eller Rengjøringsinnstillinger.

• entity: Denne blokken dekker Home Assistant-enhetsdomener som select, sensor, switch, number, time og input. Kortet henter dynamisk navnene og tilstandene til disse enhetene, slik som Suction Level eller Quiet, direkte fra integrasjonen for å sikre konsistens.

  • Kortspesifikke tilstander: Gir oversettelser for interne tilstander som brukes eksklusivt av kortets brukergrensesnitt, og ikke av Home Assistant-enheter. Dette inkluderer romnavn (avledet fra segment_name-enheten), sammen med spesifikke identifikatorer som task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method og recovery_map_type.

Dato-, tid- og enhetsformatering

I tillegg til tekstoversettelser tilpasser kortet seg automatisk lokale formateringspreferanser uten at noen manuell konfigurasjon kreves:

• Språk & lokalitet: Kortet prioriterer språket som er valgt i Home Assistant-profilen. Hvis ingen språk er eksplisitt angitt der, faller det automatisk tilbake til nettleserens standard språk.
• 12/24-timers tidsformat: Kortet følger tidsformatet som er konfigurert i Home Assistant-profilen. Hvis det ikke er spesifisert, adopterer det automatisk standard tidsformat for enhetens region.
• Første dag i uken: Kortet leser innstillingen for første dag i uken direkte fra Home Assistant. Hvis det ikke er definert, bestemmer det dynamisk om kalenderen skal starte på søndag eller mandag basert på lokal region.
• Enhetssystem: Kortet sjekker kontinuerlig Home Assistants globale konfigurasjon. Hvis systemet bruker det imperiale enhetssystemet, rekalkulerer kortet automatisk områder og avstander, og viser dem naturlig i fot, kvadratfot eller yards.
• Oversettelser av native enheter: Vanlige enhetssuffikser og forkortelser, som meter, kilometer, fot, yard, minutt og time, krever ingen manuell oversettelse. Kortet oversetter dem automatisk ved hjelp av innebygde nettleserfunksjoner spesifikt tilpasset det aktive språket.

Fiks eller forbedre oversettelser

Hvis en skrivefeil eller feil oversettelse blir identifisert, eller støtte for et nytt språk trengs, går bidragene til hoved-dreame_vacuum integrasjonslageret.

Generalisering av oversettelse

Den offisielle appen bruker ofte ulike termer for identiske parametere på tvers av forskjellige enhetsgenerasjoner. Oversettelser må bruke logiske, generaliserte navn i stedet for å kopiere den eksakte ordlyden fra APPEN. Dette forhindrer oversettelseskonflikter hvor en korreksjon rettet mot en spesifikk generasjon senere overskrives av brukere med andre enhetsgenerasjoner.

Oppdateringsprosessen innebærer følgende trinn:

1. Forgrening av depotet: Forgrening av Dreame Vacuum Home Assistant-integrasjonsdepotet på GitHub.
2. Finn oversettelsesfilen: Navigere til custom_components/dreame_vacuum/translations/-katalogen i det forgrenede depotet for å finne oversettelsesfilen som samsvarer med språkkoden, for eksempel de.json eller it.json.
3. Gjør endringene: Oppdaterer den feilaktige teksten. frontend_action, frontend_config, frontend_message, og frontend_title-blokkene håndterer brukergrensesnittrelatert tekst. entity-blokken håndterer sensornavn, valg av alternativer og deres tilstander.
4. Send inn en Pull Request: Å åpne en Pull Request til hovedlageret. Etter at Pull Requesten er gjennomgått og slått sammen til en ny versjon av integrasjonen, vil Dreame Vacuum-kortet automatisk hente de oppdaterte oversettelsene.