September 5, 2020

Change Language Open edX

Open edX uses Transifex, an open source translation platform, to power the translation of edX software into different languages. All translations are hosted at Transifex.com, which provides a web application allowing translators to write, submit, and manage their translations.

  1. Login to server and switch to edxapp environment for edX native installation.
$ sudo -H -u edxapp bash
$ source /edx/app/edxapp/edxapp_env
$ cd /edx/app/edxapp/edx-platform
  1. Install Python dependencies
$ pip install transifex-client

or when using bitnami, use this

$ sudo /opt/bitnami/apps/edx/bin/pip.edxapp install transifex-client
  1. Create the ~/.transifexrc file and set your credentials as follows:
[https://www.transifex.com]
hostname = https://www.transifex.com
username = USER
password = PASS
token =

Token is left blank. You have to have permissions for the project (edx-platform) AFAIK - https://www.transifex.com/projects/p/edx-platform/ (it is free to sign up and join this project as a translator).

  1. Make sure all languages you wish to download are present and uncommented in conf/locale/config.yaml. For example, if you wish to download Arabic and Indonesian, make sure your config.yaml file looks like this:
locales:
     - en  # English - Source Language
     - id  # Indonesian
  1. Set the value of the LANGUAGE_CODE variable to the language you desire (for example, set it to “es_es” to translate it to Spanish) in the configuration files.

For edX native installation

  • /edx/app/edxapp/lms.env.json
  • /edx/app/edxapp/cms.env.json
  • /edx/app/edxapp/edx-platform/lms/envs/common.py

For edX on bitnami

  • /opt/bitnami/apps/edx/conf/cms.env.json
  • /opt/bitnami/apps/edx/conf/lms.env.json
  • /opt/bitnami/apps/edx/edx-platform/lms/envs/common.py

Languages need to be specified with codes Django likes, so a code that is specific on Transifex such as "de_DE" must be specified as "de-de" in these configuration files. See https://groups.google.com/forum/#!topic/openedx-translation/vrOpMKzA0kU

  1. Restart lms and cms for reload configuration.

  2. Download the translations, extract and compile.

For edX native installation

$ paver i18n_robot_pull
$ paver i18n_generate

For edX on bitnami

$ cd /opt/bitnami/apps/edx/edx-platform
$ sudo /opt/bitnami/apps/edx/bin/paver.edxapp i18n_robot_pull
  1. Restart lms and cms for reload configuration.

References