How to customize i18n (translation)

pauldic
Fri, 10 Oct 2025 22:17:35 +0000
Development

I did fork the openedx-translations repository according to the tutor documentation, created a branch “teak.2-custom” on my forked repository and made my desired changes on the existing English verbiage, commit and pushed to my branch “teak.2-custom”.

docs.tutor.edly.io

Configuration and customisation — Tutor documentation

Update the atlas revision and repository in the tutor config:

tutor config save \
–set ATLAS_REVISION=“teak.2-custom” \
–set ATLAS_REPOSITORY=“MyUsername/openedx-translations”

Run these commands without error:
tutor images build mfe
tutor images build openedx
tutor local launch

I can confirm during the build for both the mfe & openedx, that it actual pulled from MyUsername/openedx-translations. However, the UI does not reflect my changes.

Please guys can you help me confirm if there is something am doing wrong?

Below if part of the log during mfe build

[+] Building 41.2s (108/149) docker:default
=> [authn-common 6/7] RUN make OPENEDX_ATLAS_PULL=true ATLAS_OPTIONS=“–repository=MyUsername/openedx-translations --revision=teak.2-custom " pull_translations 19.4s
[+] Building 41.4s (108/149) docker:default
=> [authn-common 6/7] RUN make OPENEDX_ATLAS_PULL=true ATLAS_OPTIONS=”–repository=MyUsername/openedx-translations --revision=teak.2-custom " pull_translations 19.6s
[+] Building 650.3s (128/149) docker:default
[+] Building 1738.0s (150/150) FINISHED

Below is part of the log during openedx build:

=> CACHED [production 18/37] RUN make clean_translations 0.0s
=> [production 19/37] RUN ./manage.py lms --settings=tutor.i18n pull_plugin_translations --verbose --repository=‘MyUsername/openedx-translations’ --revision=‘teak.2-custom’ 41.8s
=> [production 20/37] RUN ./manage.py lms --settings=tutor.i18n pull_xblock_translations --repository=‘MyUsername/openedx-translations’ --revision=‘teak.2-custom’ 25.3s
=> [production 21/37] RUN atlas pull --repository=‘MyUsername/openedx-translations’ --revision=‘teak.2-custom’ translations/edx-platform/conf/locale:conf/locale translations/studio-frontend/src 24.8s
=> [production 22/37] RUN ./manage.py lms --settings=tutor.i18n compile_xblock_translations 31.0s
=> [production 23/37] RUN ./manage.py cms --settings=tutor.i18n compile_xblock_translations 27.0s
=> [production 24/37] RUN ./manage.py lms --settings=tutor.i18n compile_plugin_translations 17.7s
=> [production 25/37] RUN ./manage.py lms --settings=tutor.i18n compilemessages -v1 22.2s
=> [production 26/37] RUN ./manage.py lms --settings=tutor.i18n compilejsi18n 26.5s
=> [production 27/37] RUN ./manage.py cms --settings=tutor.i18n compilejsi18n 16.7s

7 posts - 4 participants