Lokalisierung

Die Integration liefert Übersetzungen für alle generierten Entitätsnamen und Zustände über das Standardübersetzungssystem von Home Assistant, gespeichert in custom_components/dreame_vacuum/translations/*.json. Diese Dateien dienen auch als Basiswörterbuch, das nachgelagerte Benutzeroberflächen für ihre eigenen Oberflächentexte verwenden.

Übersetzungen korrigieren oder verbessern

Wenn ein Tippfehler oder eine falsche Übersetzung erkannt wird oder die Unterstützung für eine neue Sprache benötigt wird, gehen Beiträge an dieses Repository.

Allgemeine Übersetzungsinformationen

Die offizielle App verwendet häufig unterschiedliche Terminologie für identische Parameter über verschiedene Gerätegenerationen hinweg. Übersetzungen müssen logische, verallgemeinerte Namen verwenden, anstatt die genaue Formulierung aus der App strikt zu kopieren. Dies verhindert Übersetzungskonflikte, bei denen eine Korrektur, die für eine bestimmte Generation angepasst wurde, später von Nutzern mit anderen Gerätegenerationen überschrieben wird.

Der Aktualisierungsprozess umfasst die folgenden Schritte:

1. Forken des Repositorys: Das Dreame Vacuum Home Assistant Integrations-Repository auf GitHub forken.
2. Die Übersetzungsdatei finden: Navigieren zum custom_components/dreame_vacuum/translations/-Verzeichnis im geforkten Repository, um die Übersetzungsdatei zu finden, die dem Sprachcode entspricht, wie de.json oder it.json.
3. Die Änderungen vornehmen: Den falschen Text aktualisieren. Der config-Block verwaltet den Text für den Konfigurationsfluss und den Optionsfluss. Der entity-Block verwaltet Entitätsnamen, Auswahloptionen und deren Zustände.
4. Einen Pull Request einreichen: Öffnen eines Pull Requests zum dev-Branch. Nachdem der Pull Request überprüft und in eine neue Version zusammengeführt wurde, übernimmt Home Assistant automatisch die aktualisierten Übersetzungen.

Frontend-Übersetzungen

Frontend-spezifische Übersetzungsschlüssel und gemeinsame Aktionslabels werden innerhalb des entity_component-Blocks der Sprachdateien gepflegt. Für detaillierte Informationen darüber, wie Frontend-Übersetzungen strukturiert sind und von nachgelagerten UI-Komponenten verwendet werden, siehe Dokumentation der Übersetzungen der Dreame Vacuum Card.