Lokalizáció

A bővítmény minden generált entitásnév és állapot fordítását a Home Assistant standard fordítási rendszerén keresztül biztosítja, amelyek a custom_components/dreame_vacuum/translations/*.json helyen vannak tárolva. Ezek a fájlok szolgálnak alap szótárként is, amelyet a downstream felületek saját interfész szövegeikhez használnak.

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

Ha elírást vagy hibás fordítást találunk, vagy új nyelv támogatására van szükség, a hozzájárulások ehhez a tárhelyhez mennek.

Fordítás általánosítása

A hivatalos alkalmazás gyakran különböző kifejezéseket használ az azonos paraméterekre a különböző eszközgenerációk esetében. A fordításoknak logikus, általánosított neveket kell alkalmazniuk, ahelyett hogy szigorúan az alkalmazásban szereplő pontos megfogalmazást másolnák. Ez megakadályozza a fordítási konfliktusokat, amikor egy adott generációra szabott javítást később egy másik generációt használó felhasználó felülír.

A frissítési folyamat a következő lépésekből áll:

1. Forkold a tárolót: A GitHub-on található Dreame Vacuum Home Assistant integrációs tároló fork-olása.
2. Keresd meg a fordítási fájlt: Navigálás a fork-olt tároló custom_components/dreame_vacuum/translations/ könyvtárába, hogy megtaláld a nyelvkódnak megfelelő fordítási fájlt, például de.json vagy it.json.
3. Végezze el a módosításokat: A hibás szöveg frissítése. A config blokk kezeli a konfigurációs folyamat és az opciók folyamat szövegét. A entity blokk kezeli az entitásneveket, a kiválasztási lehetőségeket és azok állapotát.
4. Pull Request beküldése: Pull Request megnyitása a dev ághoz. Miután a Pull Request-et átnézték és egy új kiadásba összevonták, a Home Assistant automatikusan átvette a frissített fordításokat.

Felület Fordítások

A felület-specifikus fordítási kulcsokat és a megosztott akciócímkéket a nyelvi fájlok entity_component blokkja tartalmazza. A részletes információkért arról, hogy a felület fordításai hogyan vannak felépítve és a downstream felhasználói felület komponensei hogyan használják őket, lásd a Dreame Porszívó Kártya fordítási dokumentáció.