Lokaliseerimine

Dreame tolmuimeja kaart toetab loomuomaselt mitut keelt. See kasutab dünaamiliselt keelefaile, mida pakub backend dreame_vacuum integratsioon, selle asemel et hoida eraldi lokaliseerimisfaile.

Kaart võtab lokaliseeritud tekstiväärtused entity_component jaotisest dreame_vacuum integratsiooni tõlke failid sees.

Tõlkevõtmed

Keelefailides kasutab kaart peamiselt mitmeid võtmekategooriaid, mis algavad frontend_, et kuvada oma liidest:

• frontend_action: See jaotis sisaldab kogu teksti, mida kasutatakse kaardi põhikontrollpaneeli tegevusnuppudes, näiteks Start, Pause või Dock.

• frontend_config: See jaotis sisaldab kõiki tekstimärgiseid, kirjeldusi ja seadeid, mida kasutatakse visuaalse kaardi konfigureerija liideses.

• frontend_message: Sisaldab oleku teateid, hoiatusi, veateateid ja hoiatusteateid, mis kuvatakse kaardil.

• frontend_title: Käsitleb pealkirju ja jaotiste nimetusi, mida kasutatakse kaardi menüüdes, näiteks Map Management või Cleaning Settings.

• entity: See plokk hõlmab Home Assistanti üksuste domeene, nagu select, sensor, switch, number, time ja input. Kaart tõmbab nende üksuste nimed ja olekud dünaamiliselt, näiteks Imemisaste või Vaikselt, otse integratsioonist, et tagada järjepidevus.

  • Kaardispetsiifsed olekud: Pakub tõlkeid kaardi kasutajaliideses eranditult kasutatavate sisemiste olekute jaoks, mitte Home Assistanti üksuste jaoks. See hõlmab ruumide nimesid (tuletatud segment_name üksusest), samuti konkreetseid identifikaatoreid nagu task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method ja recovery_map_type.

Kuupäeva, kellaaja ja ühiku vormindamine

Lisaks tekstide tõlkimisele kohandub kaart automaatselt kohalikele vorminduseelistustele, ilma et oleks vaja käsitsi seadistamist:

• Keel ja lokaal: Kaart eelistab keelt, mis on valitud Home Assistanti profiilis. Kui seal keelt otseselt ei ole määratud, kasutab see automaatselt veebibrauseri vaikekeelt.
• 12/24-tunnine ajavorming: Kaart järgib Home Assistanti profiilis määratud ajavormingut. Kui see pole määratud, kasutab see automaatselt seadme piirkonna standardset ajavormingut.
• Nädala esimene päev: Kaart loeb nädala esimese päeva seadet otse Home Assistantist. Kui see pole määratletud, määrab see dünaamiliselt, kas kalender peaks algama pühapäeval või esmaspäeval, lähtudes kohalikust piirkonnast.
• Mõõtühikute süsteem: Kaart kontrollib pidevalt Home Assistanti ülemaailmset konfiguratsiooni. Kui süsteem kasutab Impeerium-süsteemi, arvutab kaart automaatselt pindalad ja kaugused ümber, näidates neid loomulikult jalgades, ruutjalgades või jardides.
• Algseadme ühikutõlkeid: Levinud ühikulühendid ja -lühendid, nagu meeter, kilomeeter, jalg, jard, minut ja tund, ei vaja käsitsi tõlget. Kaart tõlgib need reaalajas, kasutades sisseehitatud brauseri funktsioone, mis on spetsiaalselt loodud aktiivseks keeleks.

Paranda või täienda tõlkeid

Kui leitakse trükiviga või vale tõlge või on vaja uut keele tuge, lähevad panused peamise dreame_vacuum integratsiooni hoidla.

Tõlke üldistamine

Ametlik rakendus kasutab sageli erinevat terminoloogiat identsete parameetrite kohta erinevate seadmepõlvkondade vahel. Tõlked peavad kasutama loogilisi, üldistatud nimesid, mitte rangelt kopeerima APP täpset sõnastust. See hoiab ära tõlke konfliktid, kus ühe konkreetse põlvkonna jaoks tehtud parandust kirjutavad hiljem üle erinevate seadmepõlvkondade kasutajad.

Uuendusprotsess hõlmab järgmisi samme:

1. Forki hoidlus: Dreame Vacuum Home Assistant integratsiooni hoidla forkimine GitHubis.
2. Leia tõlkefail: Navigeerimine custom_components/dreame_vacuum/translations/ kausta forkitud hoidluses, et leida keelekoodi järgi sobiv tõlkefail, näiteks de.json või it.json.
3. Tee muudatused: Vale teksti uuendamine. frontend_action, frontend_config, frontend_message ja frontend_title plokid haldavad kasutajaliidese teksti. entity plokk haldab andurite nimesid, valikuvalikuid ja nende olekuid.
4. Esita Pull Request: Pull Requesti avamine põhihoidlasse. Pärast Pull Requesti ülevaatamist ja integreerimise uue versiooni lisamist võtab Dreame Vacuum Card automaatselt vastu uuendatud tõlked.