Skip to content

Internationalization and localization

Sarina Canelake edited this page Apr 13, 2014 · 38 revisions

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

  1. 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
    
  2. When you launch your LMS instance you launch it with the environment:

     $ rake lms[dev_es,0.0.0.0:8000]
    
  3. 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.
Clone this wiki locally