Internationalization and localization

We are currently hosting all translations of Open edX framework on www.transifex.com. Please feel free to make translation contributions there.

You should also join the openedx-translation Google Group.

In order to run your Open edX instance under a different spoken language, for instance for Spanish (Latin American):

1. Configure your ~/.transifexrc file:

    [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/

2. All of the languages on Transifex are already configured in the edx-platform repo. If you've added a new language to Transifex, and we haven't added it to the configuration yet, you can add it to conf/locale/config.yaml.

3. Configure it in your lms/env/common.py, for instance create one called dev_es.py with the following:

    from .dev import *
    
    USE_I18N = True
    LANGUAGES = ( ('es-419', 'Spanish'), )
    TIME_ZONE = 'America/Guayaquil'
    LANGUAGE_CODE = 'es-419'
   

Languages need to be specified with codes Django likes, so a code such as "de_DE" must be specified as "de-de" in these configuration files.

4. Execute the following commands in your edx-platform directory with your edx-platform virtualenv, replacing it with the language you want.

    $ tx pull -l es_419
    $ rake i18n:generate
   

5. When you launch your LMS instance you launch it with the environment:

    $ rake lms[dev_es,0.0.0.0:8000]