HowTo translate Redmine in your own language » History » Version 11
Harri H, 2009-07-04 18:47
Updated text to match the new way of handling locales, old directory (/lang) is now mentioned only briefly. Changed gloc -> locales and moved file updating to under its own subheader. Also fixed some typos.
| 1 | 1 | Jean-Philippe Lang | h1. HowTo translate Redmine in your own language |
|---|---|---|---|
| 2 | |||
| 3 | Redmine can easily be translated in any language. |
||
| 4 | |||
| 5 | 4 | Jean-Philippe Lang | There are a few things to translate: |
| 6 | 1 | Jean-Philippe Lang | |
| 7 | 11 | Harri H | # The main lang file, located in @/config/locales@ (or @/lang@ before r2493) |
| 8 | 9 | Azamat Hackimov | # The calendar lang file, located in @/public/javascripts/calendar/lang@ |
| 9 | # The wiki toolbar lang file, located in @/public/javascripts/jstoolbar/lang@ (for r1074 and above) |
||
| 10 | 1 | Jean-Philippe Lang | |
| 11 | Say you want to translate Redmine in Finnish (@fi@ as defined in the "IANA Language Subtag Registry":http://www.iana.org/assignments/language-subtag-registry): |
||
| 12 | |||
| 13 | 11 | Harri H | # Copy @/config/locales/en.yml@ to @fi.yml@ and translate every strings this file contains. |
| 14 | 9 | Azamat Hackimov | # Copy @/public/javascripts/calendar/lang/calendar-en.js@ to @calendar-fi.js@ and translate every strings this file contains (mainly day and month names). |
| 15 | # Copy @/public/javascripts/jstoolbar/lang/jstoolbar-en.js@ to @jstoolbar-fi.js@ and translate the strings. |
||
| 16 | 11 | Harri H | # Test your translation with command <pre>rake test</pre> If you get errors related to gloc/locales, you must fix them. |
| 17 | 1 | Jean-Philippe Lang | |
| 18 | *All these files must be UTF-8 encoded.* Do not use HTML entities in translated strings. |
||
| 19 | |||
| 20 | You can submit your translation "here":http://www.redmine.org/projects/redmine/issues/new?tracker_id=3 (login required) if you want it to be added to the next release. |
||
| 21 | 11 | Harri H | |
| 22 | 1 | Jean-Philippe Lang | As of 2009-02-21, *only updates based on the new translation files* (found in @/config/locales@) *should be submitted.* |
| 23 | 11 | Harri H | |
| 24 | h2. Updates to the language files |
||
| 25 | |||
| 26 | File @en.yml@ acts as the main language file. You can check if it has new strings by running <pre>rake locales:update</pre>. This copies the new strings to other translation files (with the English translation as default value). |