HowTo translate Redmine in your own language¶

Redmine can easily be translated in any language.

There are a few things to translate:

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

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

1. Copy /config/locales/en.yml to /config/locales/fi.yml and translate every strings this file contains.
2. Copy /public/javascripts/calendar/lang/calendar-en.js to /public/javascripts/calendar/lang/calendar-fi.js and translate every strings this file contains (mainly day and month names).
3. Copy /public/javascripts/jstoolbar/lang/jstoolbar-en.js to /public/javascripts/jstoolbar/lang/jstoolbar-fi.js and translate the strings.
4. Test your translation with command

   rake test

   If you get errors related to locales, you must fix them.

Restrictions¶

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

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

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

You can submit your translation here (login required) if you want it to be added to the next release.

As of 2009-02-21, only updates based on the new translation files (found in /config/locales) should be submitted.

Updates to the language files¶

File en.yml acts as the main language file. You can check if it has new strings by running:

rake locales:update

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