Merge pull request #602 from rowr111/small-updates-to-the-locales-readme

small updates to the locales readme
This commit is contained in:
bunnie 2024-12-10 23:53:39 +08:00 committed by GitHub
commit 946c0f7c4f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -4,8 +4,8 @@ The `lib.rs` file in this crate is auto-generated by `xtask`. It must be manuall
calling `xtask generate-locales` every time changes are made to the localization strings.
## Where are the Strings?
Locale files can be added to any server by making a `locales` directory within the server, and
then placing a `.json` file in there with a format like this:
Locale files can be added to any app, service, etc by making a `locales` directory within the item's top level folder, and
then placing a `i18n.json` file in there with a format like this:
```json
{
@ -36,6 +36,8 @@ Note that "en-tts" is a locale for english/vision-impaired. `🔇` means that an
for that locale (can be used in any locale, not just speech-to-text locales). Omitting a locale
entirely without using the 🔇 character will lead to a panic.
There are also locale files `i18n.json` and `manifest.json` in the `apps` folder itself for strings relevant to menu items etc. If you add an app you will want to add items here as well.
## How to Code with Locales
The JSON file is parsed by `xtask` into a lib.rs file which is referred to within a server by
the following idiom:
@ -163,8 +165,8 @@ is present it will be treated as the original version.
_NOTE:_ You may want to add the new lang to the other tools
that know about available languages:
* https://github.com/betrusted-io/xous-core/blob/main/tools/updater/precursorupdater/precursorupdater.py#L154
* https://github.com/betrusted-io/xous-core/blob/main/tools/backup.py#L420
* https://github.com/betrusted-io/xous-core/blob/main/tools/restore.py#L541
* https://github.com/betrusted-io/xous-core/blob/main/tools/updater/precursorupdater/precursorupdater.py#L620
* https://github.com/betrusted-io/xous-core/blob/main/tools/backup.py#L435
* https://github.com/betrusted-io/xous-core/blob/main/tools/restore.py#L557
* https://github.com/betrusted-io/xous-core/blob/main/tools/legacy/update_ci.sh#L14
* https://github.com/betrusted-io/xous-core/blob/main/tools/legacy/factory_reset.sh#L14