Lokalizácia

Karta Dreame Vacuum natívne podporuje viacero jazykov. Dynamicky používa jazykové súbory poskytované integráciou backendu dreame_vacuum, namiesto udržiavania samostatných lokalizačných súborov.

Karta získava lokalizované textové hodnoty z časti entity_component v rámci dreame_vacuum súbory prekladu integrácie.

Kľúče prekladu

V jazykových súboroch karta primárne používa niekoľko kategórií kľúčov začínajúcich na frontend_ na zobrazenie svojho rozhrania:

• frontend_action: Táto časť obsahuje všetky texty používané v tlačidlách akcií na hlavnom ovládacom paneli karty, ako napríklad Štart, Pozastaviť alebo Doku.

• frontend_config: Táto časť obsahuje všetky textové štítky, popisy a nastavenia používané vo vizuálnom konfigurátore karty.

• frontend_message: Obsahuje stavové správy, upozornenia, správy o chybách a varovania zobrazené na karte.

• frontend_title: Zahŕňa nadpisy a názvy sekcií používané v ponukách karty, ako napríklad Správa máp alebo Nastavenia čistenia.

• entity: Tento blok pokrýva entity domény Home Assistant, ako sú select, sensor, switch, number, time a input. Karta dynamicky načítava názvy a stavy týchto entít, ako napríklad Úroveň sacia alebo Tichý, priamo z integrácie, aby sa zabezpečila konzistencia.

  • Stavy špecifické pre kartu: Poskytuje preklady pre interné stavy používané výlučne v používateľskom rozhraní karty, nie v entitách Home Assistant. To zahŕňa názvy miestností (odvodené od entity segment_name), spolu so špecifickými identifikátormi ako task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method a recovery_map_type.

Formátovanie dátumu, času a jednotiek

Okrem prekladov textov sa karta automaticky prispôsobuje miestnym formátovacím preferenciám bez potreby manuálnej konfigurácie:

• Jazyk a locales: Karta uprednostňuje jazyk vybraný v profile Home Assistant. Ak tu nie je jazyk explicitne nastavený, automaticky sa použije predvolený jazyk webového prehliadača.
• Formát času 12/24 hodín: Karta rešpektuje formát času nastavený v profile Home Assistant. Ak nie je špecifikovaný, automaticky preberá štandardný formát času podľa regiónu zariadenia.
• Prvý deň v týždni: Karta číta nastavenie prvého dňa v týždni priamo z Home Assistant. Ak nie je definované, dynamicky určuje, či kalendár začne v nedeľu alebo pondelok podľa miestnej oblasti.
• Systém jednotiek: Karta priebežne kontroluje globálne nastavenia Home Assistant. Ak systém používa imperiálny systém jednotiek, karta automaticky prepočíta plochy a vzdialenosti, pričom ich natívne zobrazí v stopách, štvorcových stopách alebo yardoch.
• Preklady nativných jednotiek: Bežné jednotkové prípony a skratky, ako meter, kilometer, stopa, yard, minúta a hodina, nevyžadujú žiadny manuálny preklad. Karta ich prekladá automaticky pomocou vstavaných funkcií prehliadača prispôsobených konkrétnemu aktívnemu jazyku.

Opraviť alebo vylepšiť preklady

Ak sa identifikuje preklep alebo nesprávny preklad, alebo je potrebná podpora nového jazyka, príspevky smerujú do hlavného dreame_vacuum integračného repozitára.

Generalizácia prekladu

Oficiálna aplikácia často používa rôznu terminológiu pre identické parametre naprieč rôznymi generáciami zariadení. Preklady musia používať logické, generalizované názvy namiesto striktného kopírovania presného znenia z APP. To zabraňuje konfliktom prekladov, kde oprava určená pre konkrétnu generáciu by bola následne prepísaná používateľmi s inými generáciami zariadení.

Proces aktualizácie zahŕňa nasledujúce kroky:

1. Rozdvojte úložisko: Rozdvojte úložisko integrácie Dreame Vacuum Home Assistant na GitHub.
2. Nájdite súbor s prekladom: Prejdite do adresára custom_components/dreame_vacuum/translations/ v rozdelenom úložisku a vyhľadajte súbor prekladu, ktorý zodpovedá kódu jazyka, napríklad de.json alebo it.json.
3. Urobte zmeny: Aktualizujte nesprávny text. Bloky frontend_action, frontend_config, frontend_message a frontend_title spravujú text súvisiaci s používateľským rozhraním. Blok entity spravuje názvy senzorov, možnosti výberu a ich stavy.
4. Odošlite žiadosť o zmenu (Pull Request): Otvorte Pull Request do hlavného úložiska. Po preskúmaní a zlúčení Pull Request do novej verzie integrácie Dreame Vacuum Card automaticky prevezme aktualizované preklady.