From f234d19992eb86c5008583d5c30efc2ca0ed4c2a Mon Sep 17 00:00:00 2001 From: grdddj Date: Mon, 12 Feb 2024 14:44:17 +0100 Subject: [PATCH] docs(core): add documentation for translations [no changelog] --- docs/core/misc/translations.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/core/misc/translations.md diff --git a/docs/core/misc/translations.md b/docs/core/misc/translations.md new file mode 100644 index 0000000000..ccf54cd4e6 --- /dev/null +++ b/docs/core/misc/translations.md @@ -0,0 +1,19 @@ +# Translations + +## Overview + +`Trezor` stores translated strings in `.json` files in [core/translations directory](../../../core/translations) - e.g. [de.json](../../../core/translations/de.json). + +When no foreign-language is present, the English version is used - [en.json](../../../core/translations/en.json). + +Translations files contain the translated strings and also all the special font characters as a link to `.json` files in [fonts](../../../core/translations/fonts) directory. Font files are not needed for `english`, which uses just default/built-in `ASCII` characters. + +## Generating blobs + +To generate up-to-date blobs, use `python core/translations/cli.py gen` - they will appear in `core/translations` as `translations-*.bin` files. The files contain information about the specific hardware model, language and device version. + +## Uploading blobs + +To upload blobs with foreign-language translations, use `trezorctl set language ` command. + +To switch the language back into `english`, use `trezorctl set language -r`.