Translating LimeSurvey

Translating LimeSurvey

Wouldn't it be great to have LimeSurvey completely translated to your mother-language? The LimeSurvey team is always on the look-out for new translations and for people who help to update the existing ones. Please read these instructions and don't hesitate to send email to translations@limesurvey.org if you are in doubt or have any other questions.

~tc~

(alias(LimeSurvey 1.x Translating LimeSurvey))

~/tc~

How to translate - Step-by-Step instructions

Updating an existing translation

1. Create a free user account on [1].
2. Note: If you already have an account please log in once at [2] first!
3. Go to [3], login there with the same user name and password.
4. Pick the LimeSurvey version you want to translate for and start translating. After your translation was approved it will automatically be released in the weekly stable release and your username will be credited in the change log.
5. If you are interested  to become a prime translator for your language with the ability to approve newly translated string please contact us at translations@limesurvey.org . Such a position requires a maximum of about an hour of work per week - important to us is that you are reliable doing this.

Customize an existing translation

Sometimes you want to modify an existing translation so it accommodates your particular survey situation better. In that case do the following:

1. Go to http://translate.limesurvey.org (external link), pick the LimeSurvey version you want to translate for and the particular language you want to modify.
2. On the bottom of the translation page you will find an option to export all strings as .po file. Do that and save it as *.po file to your local harddisk:
   
3. Download and install poEDIT
4. Start poEdit end edit the downloaded *.po file - modify the particular translations.
5. Save. When you save the .po file then automatically a .mo file is created too. That is the one LimeSurvey will read from.
6. Place the particular .mo file in the right language folder in /locale by replacing the existing one - for example for French this would be /locale/fr/LC_MESSAGES/fr.po
7. Done.

Note: If you are using LimeService they will be happy to place the file for you. Just create a support ticket.

Creating a new translation

1. First of all get access to the development version of LimeSurvey. You can find detailed instructions how to get your hands on it on this page: Accessing the source code
2. Download and install poEDIT
3. Now you have to find out the language-code for your language - you can search for your language-code in the IANA Language Subtag Registry.
4. Go to the /locale directory and create a directory named after your language code.
5. Inside that directory create a directory named LC_MESSAGES.
6. Now create a language file with poEdit. Save the (yet) empty file to that dir (in the /locale/your_language_code/LC_MESSAGES/ folder). The file has to be be named according to your language-code. (look into the other directory for examples)
7. In poEdit do the following:
   1. Open menu Catalog/Settings, enter the Paths-Tab
   2. Delete the existing path and add a new one pointing to the downloaded LimeSurvey sources
   3. Click on the Keywords tab, click on new item
   4. Add the keywords: 'gT', 'eT', 'neT:1,2', and 'ngT:1,2' (without quotes).
   5. On the project info tab you will find "Plural Forms" at the bottom. Just copy & paste the following into this field: 'nplurals=2; plural=n != 1;' (without quotes, again)
   6. Press 'OK' to close the settings.
   7. Open the menu entry Catalog/Update from Sources
   8. If you did everything right it should now find all untranslated strings and add it to the .po file
8. Translate everything you need to translate.
9. To make LimeSurvey know about your language you must add it to the file application/helpers/surveytranslator_helper.php. Open that file with a text editor and add your language in the same way the other languages in that file are defined.
10. Save - make sure that beside the .po file also the binary .mo file is created (that's the one LimeSurvey is reading from).
11. Send the new .po-File and the updated surveytranslator.php file to translations@limesurvey.org . If you want your name to be linked from/shown on the team-page please write so in the e-mail!