Lokalisering

Dreame Vacuum-kortet stöder flera språk som standard. Det använder dynamiskt de språkfiler som tillhandahålls av backend-dreame_vacuum-integration istället för att underhålla separata lokaliseringsfiler.

Kortet hämtar lokaliserade textvärden från entity_component-sektionen inom dreame_vacuum integrationsöversättningsfiler.

Översättningsnycklar

Inom språkfilerna använder kortet främst flera nyckelkategorier som börjar med frontend_ för att visa sitt gränssnitt:

• frontend_action: Denna sektion innehåller all text som används inuti åtgärdsknapparna på kortets huvudkontrollpanel, som Start, Pausa eller Docka.

• frontend_config: Denna sektion innehåller alla textetiketter, beskrivningar och inställningar som används i den visuella kortkonfiguratorns UI.

• frontend_message: Innehåller statusmeddelanden, varningar, felrapporter och aviseringar som visas på kortet.

• frontend_title: Täcker rubriker och sektionsnamn som används inom kortets menyer, som Kartadministration eller Rengöringsinställningar.

• entity: Detta block täcker Home Assistant-entitetsdomäner såsom select, sensor, switch, number, time och input. Kortet hämtar dynamiskt namn och tillstånd för dessa enheter, såsom Sugeffekt eller Tyst, direkt från integrationen för att säkerställa konsekvens.

  • Kort-specifika tillstånd: Tillhandahåller översättningar för interna tillstånd som används exklusivt av kortets användargränssnitt snarare än Home Assistant-enheter. Detta inkluderar rumsnamn (härlett från segment_name-entiteten), tillsammans med specifika identifierare 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 och recovery_map_type.

Datum-, tid- och enhetsformatering

Förutom textöversättningar anpassar kortet automatiskt till lokala formateringspreferenser utan att någon manuell konfiguration krävs:

• Språk & Lokala inställningar: Kortet prioriterar språket som valts i Home Assistant-profilen. Om inget språk uttryckligen anges där, används automatiskt webbläsarens standardspråk.
• 12/24-timmarsformat: Kortet respekterar tidsformatet som är konfigurerat i Home Assistant-profilen. Om det inte är angivet antar det automatiskt standardtidsformatet för enhetens region.
• Veckans första dag: Kortet läser inställningen för veckans första dag direkt från Home Assistant. Om det inte är definierat bestämmer det dynamiskt om kalendern ska börja på söndag eller måndag baserat på den lokala regionen.
• Enhetssystem: Kortet kontrollerar kontinuerligt Home Assistants globala konfiguration. Om systemet använder det imperiska enhetssystemet beräknar kortet automatiskt om områden och avstånd och visar dem på ett naturligt sätt i fot, kvadratfot eller yard.
• Översättningar av enheter: Vanliga enhetssuffix och förkortningar, såsom meter, kilometer, fot, yard, minut och timme, kräver ingen manuell översättning. Kortet översätter dem direkt med inbyggda webbläsarfunktioner som är anpassade specifikt till det aktiva språket.

Åtgärda eller förbättra översättningar

Om ett stavfel eller en felaktig översättning identifieras, eller om stöd för ett nytt språk behövs, går bidrag till huvudintegreringsförrådet dreame_vacuum.

Generalisering av översättning

Den officiella appen använder ofta olika terminologi för identiska parametrar över olika enhetsgenerationer. Översättningar måste använda logiska, generaliserade namn istället för att strikt kopiera exakt ordalydelse från APPEN. Detta förhindrar översättningskonflikter där en korrigering anpassad för en specifik generation sedan skrivs över av användare med olika enhetsgenerationer.

Uppdateringsprocessen innebär följande steg:

1. Förgrena Repositoryt: Förgrena Dreame Vacuum Home Assistant-integrationsrepositoryt på GitHub.
2. Hitta Översättningsfilen: Navigera till custom_components/dreame_vacuum/translations/-katalogen i det förgrenade repositoryt för att hitta översättningsfilen som matchar språkkoden, såsom de.json eller it.json.
3. Gör Ändringarna: Uppdatera den felaktiga texten. frontend_action, frontend_config, frontend_message och frontend_title-blocken hanterar UI-relaterad text. entity-blocket hanterar sensorernas namn, valalternativ och deras tillstånd.
4. Skicka en Pull Request: Öppna en Pull Request till huvudrepositoryt. Efter att Pull Request har granskats och sammanfogats i en ny version av integrationen, hämtar Dreame Vacuum Card automatiskt de uppdaterade översättningarna.