Lokalizace

Karta Dreame Vacuum nativně podporuje více jazyků. Dynamicky využívá jazykové soubory poskytované integrací backendu dreame_vacuum místo udržování samostatných lokalizačních souborů.

Karta načítá lokalizované textové hodnoty ze sekce entity_component v rámci dreame_vacuum integrační překladové soubory.

Překladové klíče

V jazykových souborech karta primárně používá několik kategorií klíčů začínajících na frontend_ pro zobrazení svého rozhraní:

• frontend_action: Tato sekce obsahuje všechny texty používané uvnitř akčních tlačítek na hlavním ovládacím panelu karty, jako jsou Start, Pozastavit nebo Dokovat.

• frontend_config: Tato sekce obsahuje všechny textové popisky, popisy a nastavení používané uvnitř vizuálního konfiguračního rozhraní karty.

• frontend_message: Obsahuje stavové zprávy, upozornění, zprávy o chybách a varování zobrazované na kartě.

• frontend_title: Zahrnuje nadpisy a názvy sekcí používané v menu karty, například Správa map nebo Nastavení čištění.

• entity: Tento blok pokrývá domény entit Home Assistant, jako jsou select, sensor, switch, number, time a input. Karta dynamicky načítá názvy a stavy těchto entit, například Úroveň sání nebo Tichý, přímo z integrace, aby byla zajištěna konzistence.

  • Specifické stavy karty: Poskytuje překlady pro interní stavy používané výhradně uživatelským rozhraním karty, nikoli entitami Home Assistant. To zahrnuje názvy pokojů (odvozené z entity segment_name), stejně jako specifické identifikátory jako 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átování dat, času a jednotek

Kromě překladů textů se karta automaticky přizpůsobuje místním preferencím formátování bez nutnosti ruční konfigurace:

• Jazyk a lokalizace: Karta upřednostňuje jazyk vybraný v profilu Home Assistant. Pokud zde není jazyk explicitně nastaven, automaticky se použije výchozí jazyk webového prohlížeče.
• Formát času 12/24 hodin: Karta respektuje formát času nastavený v profilu Home Assistant. Pokud není specifikován, automaticky přijme standardní formát času pro region zařízení.
• První den týdne: Karta načítá nastavení prvního dne týdne přímo z Home Assistant. Pokud není definováno, dynamicky určí, zda kalendář začne nedělí nebo pondělím podle místního regionu.
• Systém jednotek: Karta průběžně kontroluje globální konfiguraci Home Assistant. Pokud systém používá imperiální jednotky, karta automaticky přepočítá plochy a vzdálenosti a zobrazuje je nativně v stopách, čtverečních stopách nebo yardech.
• Překlady nativních jednotek: Běžné jednotkové přípony a zkratky, jako metr, kilometr, stopa, yard, minuta a hodina, nevyžadují žádný ruční překlad. Karta je překládá okamžitě pomocí vestavěných funkcí prohlížeče přizpůsobených konkrétně aktivnímu jazyku.

Opravit nebo vylepšit překlady

Pokud je identifikována chyba nebo nesprávný překlad, nebo je potřeba podpora nového jazyka, příspěvky směřují do hlavního dreame_vacuum integračního repozitáře.

Generalizace překladu

Oficiální aplikace často používá různou terminologii pro stejné parametry napříč různými generacemi zařízení. Překlady musí využívat logické, generalizované názvy, místo aby přesně kopírovaly text z aplikace. To zabraňuje konfliktům při překladu, kdy oprava určená pro konkrétní generaci je následně přepsána uživateli s jinými generacemi zařízení.

Proces aktualizace zahrnuje následující kroky:

1. Rozdvojte úložiště: Rozdvojení repozitáře integrace Dreame Vacuum Home Assistant na GitHubu.
2. Najděte soubor s překlady: Přejděte do adresáře custom_components/dreame_vacuum/translations/ v rozděleném repozitáři, kde najdete soubor s překlady odpovídajícího jazykového kódu, například de.json nebo it.json.
3. Proveďte změny: Aktualizace nesprávného textu. Bloky frontend_action, frontend_config, frontend_message a frontend_title spravují text související s uživatelským rozhraním. Blok entity spravuje názvy senzorů, možnosti výběru a jejich stavy.
4. Odešlete Pull Request: Odeslání Pull Request do hlavního repozitáře. Po zkontrolování Pull Request a jeho sloučení do nové verze integrace, Dreame Vacuum Card automaticky načte aktualizované překlady.