Translating the user interface

This section provides step by step instructions on how to translate the user interface to your favourite language.

Hint

We are very keen on receiving translations for additional languages. And it’s an easy way for you to contribute back to the frePPLe community.

  1. Edit the file contribdjangodjangosettings.py (or bindjangosettings.py in the binary Windows installation). Add the language code and description to the variable LANGUAGES:

    LANGUAGES = (
      ('en', ugettext('English')),
      ('es', ugettext('Spanish')),
      ('fr', ugettext('French')),
      ('it', ugettext('Italian')),
      ('ja', ugettext('Japanese')),
      ('nl', ugettext('Dutch')),
      ('pt', ugettext('Portuguese')),
      ('pt-br', ugettext('Brazilian Portuguese')),
      ('zh-cn', ugettext('Simplified Chinese')),
      ('zh-tw', ugettext('Traditional Chinese')),
    )
    
  2. Install an editor for gettext catalogs (.po files).

    Highly recommended is the poedit tool, which can be downloaded from http://www.poedit.net/

  3. If you intend only to improve a translation you can edit the language PO files in contribdjangofreppledblocalefolder.

  4. Copy the directory contribdjangofreppledblocaleen to a new subdirectory with the name of your language code.

    The possible language codes can be found on http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes

  5. Use poedit to open the files django.po and djangojs.po in the directories you just copied. There are around 500 strings to be translated, which should take about half a day’s work.

  6. You can now test the translations, after a restart of the web server.

    Update your user preferences to use the new language. If your browser has the new language as the preferred language, this isn’t required.

  7. The installer also needs updating to recognize the new language.

    The files contribinstallerparameters.ini and contribinstallerfrepple.nsi need straightforward editing.

  8. Interactive modules.

    If you have the more advanced interactive planning modules intalled, these may have their own translation files (ex: ‘’contrib\django\freppledb\forecast\static\forecast\po” folder).

    These files will then need to be compiled into the translation.js file, requiring Grunt and angular-gettext installed.

    Optionaly you may send us the updated PO file and we will send you the compiled translation.js file back.