Project

General

Profile

HowTo translate Redmine in your own language » History » Version 14

Azamat Hackimov, 2010-04-03 12:28

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 13 Jean-Philippe Lang
# The main lang file, located at @/config/locales@ in current trunk (or @/lang@ for 0.8.x releases)
8 9 Azamat Hackimov
# The calendar lang file, located in @/public/javascripts/calendar/lang@
9 12 Jean-Philippe Lang
# The wiki toolbar lang file, located in @/public/javascripts/jstoolbar/lang@
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 14 Azamat Hackimov
Check that your files not have BOM (Byte-order mark). BOM can be removed with command:
21
22
<pre>
23
awk '{if(NR==1)sub(/^\xef\xbb\xbf/, "");print}' < oldfile > newfile
24
</pre>
25
26 1 Jean-Philippe Lang
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.
27 11 Harri H
28 1 Jean-Philippe Lang
As of 2009-02-21, *only updates based on the new translation files* (found in @/config/locales@) *should be submitted.*
29 11 Harri H
30 1 Jean-Philippe Lang
h2. Updates to the language files
31
32 12 Jean-Philippe Lang
File @en.yml@ acts as the main language file. You can check if it has new strings by running:
33
<pre>rake locales:update</pre>
34
35
This copies the new strings to other translation files (with the English translation as default value).