nativeInstalleredx

Modify the interface language

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

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.

In order to change the language, follow the steps below:

  • Sign up and join the edX platform Transifex project as a translator. See the Transifex documentation for help with Transifex.

  • Log in to the server console.

  • Install the GCC compiler.

    • On Debian/Ubuntu, run the commands below:

      $ sudo apt-get update
      $ sudo apt-get install gcc g++
      
    • On RHEL/CentOS, run the commands below:

      $ sudo yum group install "Development Tools"
      
  • Install Python dependencies:

    $ pip install transifex-client
    
  • Create the ~/.transifexrc file and set your credentials as follows:

    [https://www.transifex.com]
    hostname = https://www.transifex.com
    username = USER
    password = PASS
    token =
    

    NOTE: Remember to replace the USER and PASS placeholders in the previous example with your Transifex credentials.

  • Make sure that all languages you wish to download are present and uncommented in the installdir/apps/edx/edx-platform/conf/locale/config.yaml.

  • 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:

    • installdir/apps/edx/conf/cms.env.json
    • installdir/apps/edx/conf/lms.env.json
    • installdir/apps/edx/edx-platform/lms/envs/common.py
  • Download the translations by running the commands below:

    $ cd installdir/apps/edx/edx-platform
    $ sudo installdir/apps/edx/bin/paver.edxapp i18n_robot_pull
    
  • Download the translation for the Forum by running the commands below:

    $ cd installdir/apps/forum/cs_comments_service
    $ bundle install --with test
    $ bundle exec bin/rake i18n:pull
    
  • Restart the Apache server to load the changes.

You can find more information at the Open edX Internationalization and localization wiki page.

Last modification September 28, 2018