ChiliProject is not maintained anymore. Please be advised that there will be no more updates.

We do not recommend that you setup new ChiliProject instances and we urge all existing users to migrate their data to a maintained system, e.g. Redmine. We will provide a migration script later. In the meantime, you can use the instructions by Christian Daehn.

Development » Contribute »

Contribute Translations

ChiliProject can easily be translated in any language.

There are a few things to translate:

  1. The main lang file, located at source:/config/locales in current trunk
  2. The calendar lang file, located in source:/public/javascripts/calendar/lang
  3. The wiki toolbar lang file, located in source:/public/javascripts/jstoolbar/lang

Say you want to translate ChiliProject to Finnish (fi as defined in the IANA Language Subtag Registry):

  1. Copy /config/locales/en.yml to /config/locales/fi.yml.
  2. Copy /public/javascripts/calendar/lang/calendar-en.js to /public/javascripts/calendar/lang/calendar-fi.js.
  3. Copy /public/javascripts/jstoolbar/lang/jstoolbar-en.js to /public/javascripts/jstoolbar/lang/jstoolbar-fi.js.
  4. Translate every string in these files.
  5. Test your translation with command 
    rake test
    If you get errors related to locales, you must fix them.
  6. Submit your translation by following the process to Contribute Code. In short, that means
    1. Create a new issue (login required)
    2. Attach your translations by either
      • attaching them as plain files or a patch, or
      • sending a pull request on Github and linking to it in the issue.
  7. Wait until your translations are merged.
  8. Enjoy your work :)
  9. GOTO 4 if needed.

Restrictions

All these files must be UTF-8 encoded. Do not use HTML entities in translated strings.

Check that your files not have a BOM (Byte-order mark). The BOM can be removed with command:

awk '{if(NR==1)sub(/^\xef\xbb\xbf/, "");print}' < oldfile > newfile

Updates to the language files

As English is the default language of ChiliProject en.yml acts as the main language file. You can check if it has new strings by running:

rake locales:update

This command copies the new strings to all other translation files (with the English translation as default value).