Skip to content

Commit

Permalink
Merge pull request #602 from rowr111/small-updates-to-the-locales-readme
Browse files Browse the repository at this point in the history
small updates to the locales readme
  • Loading branch information
bunnie authored Dec 10, 2024
2 parents 05f0f96 + 3f67784 commit 946c0f7
Showing 1 changed file with 7 additions and 5 deletions.
12 changes: 7 additions & 5 deletions locales/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
{
Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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

0 comments on commit 946c0f7

Please sign in to comment.