Lokalizacja

Integracja dostarcza tłumaczenia dla wszystkich wygenerowanych nazw jednostek i stanów poprzez standardowy system tłumaczeń Home Assistant, przechowywany w custom_components/dreame_vacuum/translations/*.json. Pliki te służą również jako podstawowy słownik, z którego korzystają interfejsy użytkownika w dół łańcucha w celu własnego tekstu interfejsu.

Popraw lub ulepsz tłumaczenia

Jeśli zostanie zidentyfikowana literówka lub niepoprawne tłumaczenie, albo potrzebne będzie wsparcie dla nowego języka, wkłady kierowane są do tego repozytorium.

Uogólnienie tłumaczeń

Oficjalna aplikacja często używa różnych terminów dla identycznych parametrów w różnych generacjach urządzeń. Tłumaczenia muszą korzystać z logicznych, uogólnionych nazw, zamiast dokładnie kopiować słowa z aplikacji. To zapobiega konfliktom w tłumaczeniu, gdy poprawka dopasowana do jednej konkretnej generacji jest następnie nadpisywana przez użytkowników z innymi generacjami urządzeń.

Proces aktualizacji obejmuje następujące kroki:

1. Forkuj repozytorium: Forkowanie Repozytorium integracji Dreame Vacuum Home Assistant na GitHub.
2. Znajdź plik tłumaczenia: Przejdź do katalogu custom_components/dreame_vacuum/translations/ w forku repozytorium, aby zlokalizować plik tłumaczenia odpowiadający kodowi języka, np. de.json lub it.json.
3. Wprowadź zmiany: Aktualizacja niepoprawnego tekstu. Blok config zarządza tekstem przepływu konfiguracji i przepływu opcji. Blok entity zarządza nazwami encji, opcjami wyboru i ich stanami.
4. Złóż Pull Request: Otwarcie Pull Request w gałęzi dev. Po przejrzeniu Pull Request i po jego scaleniu w nową wersję, Home Assistant automatycznie pobiera zaktualizowane tłumaczenia.

Tłumaczenia frontendowe

Klucze tłumaczeń specyficzne dla frontendu i wspólne etykiety akcji są utrzymywane w ramach bloku entity_component plików językowych. Aby uzyskać szczegółowe informacje na temat struktury tłumaczeń frontendowych i sposobu ich wykorzystywania przez komponenty UI, zobacz Dokumentacja tłumaczeń karty Dreame Vacuum.