-
Notifications
You must be signed in to change notification settings - Fork 17
Description
Overview
Now that the Windows installer supports multi-language via ISO locale codes and .po based workflow, we need to scaffold installer locales for every locale Kolibri officially supports. This issue is not to translate them yet but only to ensure every supported locale is selectable/available in the installer and has a committed .po file ready for Crowdin.
Kolibri supported locales list: kolibri/utils/i18n.py
Changes Required
For each locale code in Kolibri’s supported locales list:
- Register the locale in
installer/translations/definitions.py:- Add mapping: ISO code + installer language name + Microsoft language ID according to the example given in the following PR.
- Scaffold the translation file:
- Run
make new-language LANG=<locale>to createinstaller/translations/locale/<locale>/messages.po. ref - Commit the generated .po file.
- Run
- Expose the locale in the installer UI:
- Add a [Languages] entry in
installer/kolibri.isspointing to the generated.islpath, e.g.:
-Name: "<locale>"; MessagesFile: "translations\locale\<locale>\<locale>.isl"
- Add a [Languages] entry in
Acceptance Criteria
- Locale list matches Kolibri: The Windows installer language list includes every locale in Kolibri’s supported locales (from
kolibri/utils/i18n.py). - Definitions added: Every supported locale has an entry in
installer/translations/definitions.py(ISO code -> language name + Microsoft language ID). - PO files generated and committed: For every supported locale,
installer/translations/locale/<locale>/messages.poexists and is committed. - Installer configured: For every supported locale,
installer/kolibri.isshas a [Languages] entry pointing totranslations\locale\<locale>\<locale>.isl. - Build works:
make translations-compileruns successfully and produces .isl files for all locales.
make build-installer-windowscompletes successfully. - Manual check:
- Running the built installer (from dist-installer/) shows the full language list.
- Selecting a few languages changes the installer UI text where translations exist (translations are not required to be complete for this issue).
References
Check out the test section in the following PR.
Reviewers' Guidance
- Test plan
- Run
make translations-compile - Run
make build-installer-windows - Launch the built installer from dist-installer/ and confirm:
- The language list includes all supported locales
- Selecting at least 2–3 languages changes installer UI strings.
AI usage
This issue was written with assistance from LLMs, which were used to help structure and refine the content.
Reactions are currently unavailable