Lokalizáció

A Dreame Vacuum Card több nyelvet natívan támogat. Dinamikusan használja a háttérrendszer dreame_vacuum integrációja által biztosított nyelvi fájlokat a külön lokalizációs fájlok fenntartása helyett.

A kártya a lokalizált szöveges értékeket a entity_component szekcióból szedi a dreame_vacuum integráció fordítási fájlok-en belül.

Fordítási kulcsok

A nyelvi fájlokon belül a kártya elsősorban több kulcskategóriát használ, amelyek frontend_-val kezdődnek, hogy megjelenítse a felületét:

• frontend_action: Ez a szekció tartalmazza az összes szöveget, amely a kártya fő vezérlőpaneljén lévő műveletgombokon található, például Indítás, Szünet vagy Dokkolás.

• frontend_config: Ez a szekció tartalmazza az összes szöveges címkét, leírást és beállítást, amely a vizuális kártya konfigurátor felületén használatos.

• frontend_message: Tartalmazza az állapotüzeneteket, figyelmeztetéseket, hibajelentéseket és figyelmeztetéseket, amelyek a kártyán jelennek meg.

• frontend_title: Lefed minden címsort és szekciócímeket, amelyeket a kártya menüiben használnak, például Térképkészlet kezelése vagy Tisztítási beállítások.

• entity: Ez a blokk a Home Assistant entitás domainjeit fedi le, mint például select, sensor, switch, number, time és input. A kártya dinamikusan húzza be ezeknek az entitásoknak a neveit és állapotait, például Szívási szint vagy Csendes, közvetlenül az integrációból, hogy biztosítsa a következetességet.

  • Kártya-specifikus állapotok: Fordításokat biztosít a kártya UI-jában kizárólagosan használt belső állapotokhoz, nem a Home Assistant entitásokhoz. Ez magában foglalja a szobaneveket (a segment_name entitásból származtatva), valamint specifikus azonosítókat, mint task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method és recovery_map_type.

Dátum, idő és mértékegység formázás

A szövegfordításokon túl a kártya automatikusan alkalmazkodik a helyi formázási preferenciákhoz, manuális beállítás nélkül:

• Nyelv és helyi beállítások: A kártya elsődlegesen a Home Assistant profilban kiválasztott nyelvet részesíti előnyben. Ha ott nincs kifejezetten beállítva nyelv, automatikusan a webböngésző alapértelmezett nyelvére vált.
• 12/24 órás formátum: A kártya a Home Assistant profiljába beállított időformátumot használja. Ha nincs megadva, automatikusan a készülék régiójának szabványos időformátumát veszi át.
• A hét első napja: A kártya közvetlenül a Home Assistantból olvassa a hét első napjának beállítását. Ha nincs meghatározva, dinamikusan határozza meg, hogy a naptár vasárnappal vagy hétfővel kezdődjön a helyi régió alapján.
• Mértékegységrendszer: A kártya folyamatosan ellenőrzi a Home Assistant globális konfigurációját. Ha a rendszer az imperial (angolszász) mértékegységrendszert használja, a kártya automatikusan átszámolja a területeket és távolságokat, natívan láthatóvá téve azokat lábban, négyzetlábban vagy yardban.
• Natív egységfordítások: A gyakori egységutótagok és rövidítések, mint például méter, kilométer, láb, yard, perc és óra, nem igényelnek manuális fordítást. A kártya valós időben fordítja őket a böngésző beépített, az aktív nyelvre szabott funkcióinak segítségével.

Fordítások javítása vagy fejlesztése

Ha elírást vagy helytelen fordítást észlel, vagy új nyelv támogatása válik szükségessé, a hozzájárulások a fő dreame_vacuum integrációs tárolóhoz kerülnek.

Fordítási általánosítás

A hivatalos alkalmazás gyakran különböző terminológiát használ az azonos paraméterekre a különböző eszközgenerációkban. A fordításoknak logikus, általánosított neveket kell használniuk, ahelyett, hogy szigorúan lemásolnák az ALKALMAZÁS pontos szövegét. Ez megakadályozza a fordítási ütközéseket, amikor egy adott generációra szabott javítás később felülíródik a más eszközgenerációkkal rendelkező felhasználók által.

A frissítési folyamat a következő lépéseket tartalmazza:

1. A tároló elágaztatása: A Dreame Vacuum Home Assistant integráció GitHub-tárolójának elágaztatása.
2. A fordítási fájl megtalálása: A custom_components/dreame_vacuum/translations/ könyvtárba navigálás az elágaztatott tárolóban, hogy megtaláljuk a nyelvkódnak megfelelő fordítási fájlt, például de.json vagy it.json.
3. A változtatások elvégzése: A hibás szöveg frissítése. A frontend_action, frontend_config, frontend_message és frontend_title blokkok a felhasználói felülettel kapcsolatos szövegeket kezelik. A entity blokk a szenzorok neveit, a választási lehetőségeket és azok állapotát kezeli.
4. Húzási kérés benyújtása: Pull Request létrehozása a fő tárolóhoz. Miután a Pull Requestet áttekintették és beolvasztották az integráció új kiadásába, a Dreame Vacuum Card automatikusan átveszi a frissített fordításokat.