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 LANGUAGE_CODE in your lms/env/common.py. Or, for development purposes, create a dev file called dev_LANGCODE.py - eg 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 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

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]
   

6. If you experience issues:

   • Be sure your browser is set to prefer the language set in LANGUAGE_CODE
   • In common/djangoapps/student/views.py, the user's language code is tried to be obtained from a saved preferences file. So if you are having issues seeing your language served up, it may be because your User object has a different language saved as a preference. Try creating a new user in your environment, this should clear up the issue.