Lokalizācija

Dreame putekļsūcēja karte natīvi atbalsta vairākas valodas. Tā dinamiskā veidā izmanto valodu failus, ko nodrošina dreame_vacuum integrācija no aizmugures, nevis uztur atsevišķus lokalizācijas failus.

Karte iegūst lokalizētos teksta vērtības no entity_component sadaļas dreame_vacuum integrācijas tulkojumu faili ietvaros.

Tulkojumu atslēgas

Valodu failos karte galvenokārt izmanto vairākas atslēgu kategorijas, sākoties ar frontend_, lai parādītu savu lietotāja saskarni:

• frontend_action: Šī sadaļa satur visu tekstu, kas tiek izmantots darbību pogās kartes galvenajā vadības panelī, piemēram, Sākt, Pauzēt vai Dokēt.

• frontend_config: Šī sadaļa satur visu teksta etiķetes, aprakstus un iestatījumus, kas tiek izmantoti vizuālā kartes konfiguratora lietotāja saskarnē.

• frontend_message: Satur statusa ziņojumus, brīdinājumus, kļūdu atskaites un paziņojumus, kas tiek rādīti uz kartes.

• frontend_title: Aptver virsrakstus un sadaļu nosaukumus, kas tiek izmantoti kartes izvēlnēs, piemēram, Kartes pārvaldība vai Tīrīšanas iestatījumi.

• entity: Šis bloks aptver Home Assistant entītiju domēnus, piemēram, select, sensor, switch, number, time un input. Karte dinamiski iegūst šo entītiju nosaukumus un statusus, piemēram, Sūkšanas līmenis vai Klusums, tieši no integrācijas, lai nodrošinātu konsekvenci.

  • Kartes specifiskie statusi: Nodrošina tulkojumus iekšējiem statusiem, ko izmanto tikai kartes lietotāja saskarne, nevis Home Assistant entītijas. Tas ietver istabu nosaukumus (izvērstus no segment_name entītijas), kā arī specifiskus identifikatorus, piemēram, task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method un recovery_map_type.

Datuma, laika un vienību formatēšana

Papildus teksta tulkojumiem karte automātiski pielāgojas vietējām formatēšanas preferencēm, neprasot manuālu konfigurāciju:

• Valoda un lokalizācija: Karte priekšroku dod valodai, kas izvēlēta Home Assistant profilā. Ja tur nav skaidri iestatīta valoda, tā automātiski pāriet uz tīmekļa pārlūkprogrammas noklusējuma valodu.
• 12/24 stundu laika formāts: Karte ievēro laika formātu, kas konfigurēts Home Assistant profilā. Ja tas nav norādīts, tā automātiski pielāgojas ierīces reģiona standarta laika formātam.
• Nedēļas pirma diena: Karte tieši nolasa nedēļas pirmās dienas iestatījumu no Home Assistant. Ja tas nav definēts, tā dinamiskā veidā nosaka, vai kalendārs jāuzsāk svētdienā vai pirmdienā, balstoties uz vietējo reģionu.
• Vienību sistēma: Karte nepārtraukti pārbauda Home Assistant globālos iestatījumus. Ja sistēma izmanto impērijas vienību sistēmu, karte automātiski pārrēķina platības un attālumus, dabiskā veidā parādot tos pēdās, kvadrātpēdās vai jardos.
• Dzimto vienību tulkojumi: Bieži izmantotie vienību sufiksi un saīsinājumi, piemēram, metrs, kilometrs, pēda, jards, minūte un stunda, neprasa manuālu tulkošanu. Karte tulko tos tiešsaistē, izmantojot iebūvētas pārlūkprogrammas funkcijas, kas pielāgotas konkrētajai aktīvajai valodai.

Labot vai uzlabot tulkojumus

Ja tiek konstatēta drukas kļūda vai nepareizs tulkojums, vai nepieciešama atbalsta pievienošana jaunai valodai, ieguldījumi tiek veikti galvenajā dreame_vacuum integrācijas repozitorijā.

Tulkojuma vispārināšana

Oficiālā lietotne bieži izmanto dažādus terminus vienādiem parametriem dažādās ierīču paaudzēs. Tulkojumiem jāizmanto loģiski, vispārināti nosaukumi, nevis stingri jākopē precīzs APP vārdu formulējums. Tas novērš tulkojumu konfliktus, kad labojums, kas pielāgots konkrētai paaudzei, tiek pārrakstīts citu ierīču paaudžu lietotāju dēļ.

Atjaunināšanas process ietver šādas darbības:

1. Fork Repository: Forkējiet Dreame Vacuum Home Assistant integrācijas repozitoriju GitHub.
2. Atrodiet tulkojuma failu: Dodieties uz custom_components/dreame_vacuum/translations/ direktoriju forkētajā repozitorijā, lai atrastu tulkojuma failu, kas atbilst valodas kodam, piemēram, de.json vai it.json.
3. Veiciet izmaiņas: Atjauniniet nepareizo tekstu. Bloki frontend_action, frontend_config, frontend_message un frontend_title pārvalda lietotāja saskarni saistīto tekstu. Bloks entity pārvalda sensoru nosaukumus, izvēles opcijas un to stāvokļus.
4. Iesniedziet Pull Request: Atveriet Pull Request uz galveno repozitoriju. Pēc tam, kad Pull Request ir pārskatīts un apvienots jaunā integrācijas izlaidumā, Dreame Vacuum Card automātiski saņem atjauninātos tulkojumus.