Lokalisering

Dreame Vacuum-kortet understøtter flere sprog som standard. Det bruger dynamisk de sprogfiler, som leveres af backend-dreame_vacuum-integration, i stedet for at opretholde separate lokaliseringsfiler.

Kortet henter lokaliserede tekstværdier fra entity_component-sektionen i dreame_vacuum integrationsoversættelsesfiler.

Oversættelsesnøgler

Inden for sprogfilene bruger kortet primært flere nøglekategorier, der starter med frontend_, til at vise sin grænseflade:

• frontend_action: Denne sektion indeholder al tekst, der bruges inde i handlingsknapperne på kortets hovedkontrolpanel, såsom Start, Pause eller Dok.

• frontend_config: Denne sektion indeholder alle tekstetiketter, beskrivelser og indstillinger, der bruges inde i den visuelle kortkonfigurator-brugerflade.

• frontend_message: Indeholder statusbeskeder, alarmer, fejlrappporter og advarsler vist på kortet.

• frontend_title: Dækker overskrifter og sektionstitler, der bruges inden for kortets menuer, såsom Kortstyring eller Rengøringsindstillinger.

• entity: Denne blok dækker Home Assistant-entitetsdomæner såsom select, sensor, switch, number, time og input. Kortet henter dynamisk navnene og tilstandene for disse enheder, såsom Suge niveau eller Stille, direkte fra integrationen for at sikre konsistens.

  • Kort-specifikke tilstande: Giver oversættelser for interne tilstande, der udelukkende bruges af kortets brugerflade og ikke Home Assistant-enheder. Dette inkluderer rumnavne (afledt af segment_name-enheden), sammen med specifikke 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 enhedsformatering

Ud over tekstoversættelser tilpasser kortet automatisk til lokale formateringspræferencer uden behov for manuel konfiguration:

• Sprog & lokalitet: Kortet prioriterer det sprog, der er valgt i Home Assistant-profilen. Hvis der ikke er angivet noget sprog der, falder det automatisk tilbage til standardindstillingerne for webbrowserens sprog.
• 12/24-timers tidsformat: Kortet respekterer tidsformatet konfigureret i Home Assistant-profilen. Hvis det ikke er angivet, adopterer det automatisk standardtidsformatet for enhedens region.
• Første dag i ugen: Kortet læser indstillingen for første dag i ugen direkte fra Home Assistant. Hvis det ikke er defineret, afgør det dynamisk, om kalenderen skal starte på søndag eller mandag baseret på den lokale region.
• Enhedssystem: Kortet tjekker løbende Home Assistants globale konfiguration. Hvis systemet bruger det imperialistiske enhedssystem, genberegner kortet automatisk områder og afstande og viser dem naturligt i fod, kvadratfod eller yards.
• Oversættelser af native enheder: Almindelige enhedssuffikser og forkortelser, såsom meter, kilometer, fod, yard, minut og time, kræver ingen manuel oversættelse. Kortet oversætter dem automatisk ved hjælp af indbyggede browserfunktioner, der er specielt tilpasset det aktive sprog.

Ret eller forbedr oversættelser

Hvis en stavefejl eller forkert oversættelse identificeres, eller der er behov for understøttelse af et nyt sprog, går bidrag til hoved-dreame_vacuum integrationslageret.

Generalisering af oversættelser

Den officielle app bruger ofte forskellige terminologier for identiske parametre på tværs af forskellige enhedsgenerationer. Oversættelser skal bruge logiske, generaliserede navne frem for strengt at kopiere den præcise formulering fra APP'en. Dette forhindrer oversættelseskonflikter, hvor en rettelse tilpasset en specifik generation efterfølgende overskrives af brugere med forskellige enhedsgenerationer.

Opdateringsprocessen involverer følgende trin:

1. Fork Repositoryet: Forking af Dreame Vacuum Home Assistant integrationsrepositoryet på GitHub.
2. Find Oversættelsesfilen: Navigering til custom_components/dreame_vacuum/translations/-mappen i det forkede repository for at finde oversættelsesfilen, der matcher sprogkoden, såsom de.json eller it.json.
3. Foretag Ændringerne: Opdatering af den forkerte tekst. frontend_action, frontend_config, frontend_message og frontend_title-blokke styrer tekst relateret til brugergrænsefladen. entity-blokken styrer sensor-navne, valgmuligheder og deres tilstande.
4. Indsend en Pull Request: Åbning af en Pull Request til hovedrepositoryet. Efter Pull Requesten er gennemgået og flettet ind i en ny udgivelse af integrationen, opdaterer Dreame Vacuum Card automatisk de opdaterede oversættelser.