Allow translations to be provided on external media

[woodcoder]

This PR provides support for extending or overriding the standard gettext language translations for the canute-ui.

The change will look for a locale directory on removable media (SD card or USB drive) containing files such as: de_DE.UTF-8@ueb1/LC_MESSAGES/canute.mo

These should be compiled from the canute.po file containing translations, based on the most up to date canute.pot template file.

When found, each file is checked for a msgid "Language Name, UEB grade" entry which should provide the actual language name for that file, in a suitable form for showing in the language and code menu list.

If there are duplicate languages with the exact same code, then the files on SD are taken, followed by USB1 & USB2 before finally falling back to the built-in translations supplied with the unit/this repo.

If a state file contains a language code that is no longer available, it will fall back to using en_GB.UTF-8@ueb2.

If no languages are found on external media then the only effect this PR has is to show the language menu in a different order (it sorts by the language code so de_DE is shown before en-GB).

Fixes #198

[pachpict]

Thanks Andy, looks spot on. Sent from Proton Mail Android

…

-------- Original Message --------

On 1/5/25 6:29 PM, Andy Wood wrote: This PR provides support for extending or overriding the standard gettext language translations for the canute-ui. The change will look for a locale directory on removable media (SD card or USB drive) containing files such as: ***@***.***/LC_MESSAGES/canute.mo These should be compiled from the canute.po file containing translations, based on the most up to date canute.pot template file. When found, each file is checked for a msgid "Language Name, UEB grade" entry which should provide the actual language name for that file, in a suitable form for showing in the language and code menu list. If there are duplicate languages with the exact same code, then the files on SD are taken, followed by USB1 & USB2 before finally falling back to the built-in translations supplied with the unit/this repo. If a state file contains a language code that is no longer available, it will fall back to using ***@***.*** If no languages are found on external media then the only effect this PR has to show the language menu in a different order (it sorts by the language code so de_DE is shown before en-GB). Fixes [#198](#198) --------------------------------------------------------------- You can view, comment on, or merge this pull request online at: #316 Commit Summary - [4a9676d](4a9676d) Read translations from locale dirs on removable media if found - [50f8e21](50f8e21) Fix import and config reading - [60476d7](60476d7) Merge commit '2c70dd105bd1b040bde07ad7ec16d965c420d11d' into 198-translation-packs - [79d32d9](79d32d9) Add some additional exception handling to avoid silent exit from async task - [7ca4b65](7ca4b65) Properly translate the language titles and improve error reporting - [9feaa8d](9feaa8d) Remove unused translation files File Changes ([20 files](https://github.com/Bristol-Braille/canute-ui/pull/316/files)) - M [INSTALL.md](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-09b140a43ebfdd8dbec31ce72cafffd15164d2860fd390692a030bcb932b54a0) (8) - M [ui/i18n.py](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-4215b83ac5d2492b604d84e830c78cfc569e126d7f44cdd277c245dca4b9cb62) (113) - M [ui/language/state.py](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-1550f18f63f7969dccded7e376a62d02a3d845f4d9a21ca5886fde41fc6ca145) (4) - M [ui/language/view.py](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-119cc54d98543d6c991340830c02562d7ec39e71f470ae70b933de7be67cb1a8) (2) - M [ui/locale/README.txt](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-85d7a5adb8fc5104ce2f4006f3e4e9aa22886ed053831b863321de63d6fc4600) (2) - M [ui/locale/canute.pot](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-744f8721bddfebb637f3d8099f247f868b005bf7c46b65e07054feb4a4f026b7) (34) - D [ui/locale/canute_de_DE.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-be64620a5f5b48fcbc887428e1e76cdf20e01c75a7e21eef1d680810116ec5b5) (206) - D [ui/locale/canute_en_GB.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-36ab390cadfb3ac0281fa7ac66181ae60e3c2853fe4b4e6036870a50de5e1c7f) (214) - D [ui/locale/canute_es_MX.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-5e6c2c17f12a55289e01ca5d0b9b4c126dc54e6a60b9cc89552057dd555faaf1) (214) - M ***@***.***/LC_MESSAGES/canute.mo](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-01397905d7ef067bbb953036918cb337fc99a874727e4503e45f8dda4451ea70) (0) - M ***@***.***/LC_MESSAGES/canute.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-0439b37055d4bd68a09ecc1f0e4fd8256c58d81481f633cf28aa66a14afa31f1) (29) - M ***@***.***/LC_MESSAGES/canute.mo](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-957c15a7158c3ad99d806f5ccfff45e0c29f53dfd5b7d1bdbaacafed7cac0d4d) (0) - M ***@***.***/LC_MESSAGES/canute.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-5c6e22a541dff515456200b4dac727e6e6e8df2a024278d8ddfd8b7ef3d4cdef) (29) - D [ui/locale/de_DE/LC_MESSAGES/canute.mo](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-94e87f21c6f9ea8e0f7e92f5a2fc64ac72b99a1b278826e30d9cff50a4bcfaf9) (0) - M ***@***.***/LC_MESSAGES/canute.mo](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-091e6d00be788db9cebc40f34f97e9e335569b36003a3b91ee1b37236153019a) (0) - M ***@***.***/LC_MESSAGES/canute.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-fa95aef31c597c1cbe14f5dc2cbb2d351a2d5e2259bd0f5c9925954d0f7937b7) (29) - M ***@***.***/LC_MESSAGES/canute.mo](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-0e3a7dc3f8992af833e41a8f048d28159bae146fa9af74b99b5f89029fdb3145) (0) - M ***@***.***/LC_MESSAGES/canute.po](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-a78894e4a21e69870aac743723b946a1424d9ceec836abc646fa35798aa276a4) (29) - D [ui/locale/es_MX/LC_MESSAGES/canute.mo](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-db5120845cc5958060c827d6ddd0f76bf1b3f51765a2e0af3b547efa0e9f918f) (0) - M [ui/main.py](https://github.com/Bristol-Braille/canute-ui/pull/316/files#diff-322cecd6d0483b9e9131a7d6fedf13c2ce90791fb7f50c340654637ffadcac4c) (86) Patch Links: - https://github.com/Bristol-Braille/canute-ui/pull/316.patch - https://github.com/Bristol-Braille/canute-ui/pull/316.diff — Reply to this email directly, [view it on GitHub](#316), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/AAGYM2QMY56SYIIPRG4HLXL2JF2ZRAVCNFSM6AAAAABUULOEDGVHI2DSMVQWIX3LMV43ASLTON2WKOZSG43DSMZZGUZDONA). You are receiving this because your review was requested.Message ID: ***@***.***>