![]() |
1 year ago | |
---|---|---|
.. | ||
lib | 2 years ago | |
po | 1 year ago | |
Community_made_translations.md | 2 years ago | |
README.md | 2 years ago | |
config.sh | 2 years ago | |
fw-build.sh | 1 year ago | |
fw-clean.sh | 2 years ago | |
iso639-1.txt | 6 years ago | |
lang-build.py | 2 years ago | |
lang-check.py | 1 year ago | |
lang-extract.py | 2 years ago | |
lang-map.py | 2 years ago | |
lang-patchsec.py | 2 years ago | |
update-po.sh | 2 years ago | |
update-pot.sh | 2 years ago |
Multi-language support in the Prusa MK3 firmware is based on PO language files.
Firmware support is controlled by the LANG_MODE
define in the configuration, which defaults to 1 (enabled). When LANG_MODE
is set, the firmware can load additional languages, but these extra languages need to be "baked in" in the firmware image for flashing. This last step is performed using the tools in this directory.
Python 3 with the regex
, pyelftools
and polib
modules as well as gettext
and dos2unix
. On a debian-based distribution, install the required packages with:
sudo apt-get install python3-regex python3-pyelftools python3-polib gettext dos2unix
Language files:
po/Firmware.pot
: Main list of strings to translate (do not change this file manually - it is automatically generated)po/Firmware_XY.po
: Translations for "XY", where XY is the ISO639-1 language code.PO files are simple text files that can be edited with any text editor, but are best handled using dedicated tools such as POEdit, Lokalize or Linguist.
High-level tools:
config.sh
: Language selection/configurationfw-build.sh
: Builds the final multi-language hex file into this directoryfw-clean.sh
: Cleanup temporary files left by fw-build.sh
update-pot.sh
: Extract internationalized strings from the sources and place them inside po/Firmware.pot
update-po.sh
: Refresh po file/s with new translations from the main pot file.Lower-level tools:
lang-check.py
: Checks a single po file for screen formatting issues.lang-extract.py
: Extract internationalized strings from source files.lang-map.py
: Extract and patch the translation symbol map in the firmware.lang-build.py
: Build a binary language catalog for a single po file.lang-patchsec.py
: Embed a single secondary language catalog in the firmware.This is accomplished by running fw-build.sh
after building the firmware with LANG_MODE = 1
. Language selection is done by modifying config.sh
.
After running the script, the final Firmware-intl.hex
will be generated in this directory.
This step is already performed for you when using build.sh
or PF-build.sh
. You can however re-run fw-build.sh
to update just the language catalogs inside the image.
If you see a typo or an incorrect translation, simply edit po/Firmware_XY.po
and make a pull request with the changes.
You can use the following command:
./lang-check.py po/Firmware_XY.po
to check for screen formatting issues in isolation, or use the --information
flag:
./lang-check.py --information po/Firmware_XY.po
to preview all translations as formatted on the screen.
If some text is missing, but there is no reference text in the po file, you need to refresh the translation file by picking up new strings and annotations from the template.
Run ./update-po.sh po/Firmware_XY.po
to propagate the new strings to your language. This will merge the new strings, update references/annotations as well as marking unused strings as obsolete.
Update the translations, then proceed as for typo or incorrect translation.
The screen annotations as well as the original english text is extracted from the firmware sources. Do not change the main pot file. The pot
and po
file contains the location of the annotation to help you fix the sources themselves.
Run ./update-pot.sh
to regenerate po/Firmware.pot
and verify that the annotation has been picked up correctly. You can stop here if you only care about the annotation.
Run ./update-po.sh po/Firmware_XY.po
otherwise to propagate the annotation to your language, then proceed as for typo or incorrect translation.
Each language is assigned a two-letter ISO639-1 language code.
The firmware needs to be aware of the language code. It's probably necessary to update the "Language codes" section in Firmware/language.h
to add the new code as a LANG_CODE_XY
define as well as add the proper language name in the function lang_get_name_by_code
in Firmware/language.c
.
It is a good idea to ensure the translation template is up-to-date before starting to translate. Run ./update-pot.sh
to regenerate po/Firmware.pot
if possible.
Copy po/Firmware.pot
to po/Firmware_XY.po
. The same language code needs to be used for the "Language" entry in the metadata. Other entries can be customized freely.
The new language needs to be explicitly added to the list of bundled languages in config.sh
.
At this point the new language should be picked-up normally. See how to build an internationalized firmware and use lang-check.py
for previewing the translation without having to perform a complete rebuild.
TODO