Revision as of 12:51, 2 August 2017

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.

How to translate - step-by-step instructions

Updating an existing translation

Sign up on the LimeSurvey website and then log in to your account.
Go to https://translate.limesurvey.org, and log in there with the same user name and password.
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 user name will be credited in the change log.
If you are interested to become a prime translator for your language with the ability to approve newly translated strings, please contact us at translations@limsurvey.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:

Go to https://translate.limesurvey.org, pick the LimeSurvey version you want to translate for and the particular language you want to modify.
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:
Download and install poEDIT.
Start poEdit and edit the downloaded *.po file - modify the particular translations.
When you save the *.po file, a *.mo file is automatically created. That is the one LimeSurvey will read from.
Place the particular *.mo file in the right language folder in /locale by replacing the existing one.

For example, the location for French would be <LimeSurvey_root_directory>/locale/fr/LC_MESSAGES/fr.po.

Done.

Note: If you are using LimeSurvey Professional, the team will be happy to place the file for you. Just create a support ticket and attach the *.po file (not the .*mo).

Creating a new translation

First of all, get access to the development version of LimeSurvey. For detailed instructions, access the following page: Accessing the source code.
Download and install poEDIT .
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 (external link).
Go to the /locale directory (located in the LimeSurvey root directory) and create a directory named after your language code.
Download your language template by clicking on the following link https://www.limesurvey.org/limesurvey.pot. Once you receive the language template file, rename it to <your_language_code>.po.
Copy the <your_language_code>.po file to the newly created folder located in the /locale directory.
Open the file with poEdit and translate everything you need to translate.
To make LimeSurvey know about your language, you must add it to the file application/helpers/surveytranslator_helper.php (located in the LimeSurvey root directory). Open that file with a text editor and add your language in the same way the other languages in that file are defined.
Save - in order to allow LimeSurvey to see the newly added language, save the modified *.po file, which will automatically create the *.mo file.
Send the new *.po-File and the updated surveytranslator_helper.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!

@@ Line 6: / Line 6: @@
 <!--T:3-->
-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.
+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 [mailto:translations@limesurvey.org translations@limesurvey.org] if you are in doubt or have any other questions.
-=How to translate - Step-by-Step instructions= <!--T:4-->
+=How to translate - step-by-step instructions= <!--T:4-->
 ==Updating an existing translation== <!--T:5-->
-#Create a free user account on [https://www.limesurvey.org the LimeSurvey website]. "Note: If you already have an account, please log in first on the [https://www.limesurvey.org LimeSurvey website]!"
+#Sign up on [https://www.limesurvey.org the LimeSurvey website] and then log in to [https://www.limesurvey.org/login your account].
-#Go to [https://translate.limesurvey.org https://translate.limesurvey.org], log in there with the same user name and password.
+#Go to [https://translate.limesurvey.org https://translate.limesurvey.org], and log in there with the same user name and password.
 #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 user name will be credited in the change log.
-#If you are interested to become a prime translator for your language with the ability to approve newly translated strings, please contact us at [mailto:translations@limesurvey.org traslations@limsurvey.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.
+#If you are interested to become a prime translator for your language with the ability to approve newly translated strings, please contact us at [mailto:translations@limesurvey.org translations@limsurvey.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== <!--T:6-->
 <!--T:7-->
-Sometimes you want to modify an existing translation so it accommodates your particular survey situation better. In that case do the following:
+Sometimes you want to modify an existing translation so it accommodates your particular survey situation better. In that case, do the following:
-#Go to https://translate.limesurvey.org (external link), pick the LimeSurvey version you want to translate for and the particular language you want to modify.
+#Go to [https://translate.limesurvey.org https://translate.limesurvey.org], pick the LimeSurvey version you want to translate for and the particular language you want to modify.
-#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:<br />[[File:export_po_file.png]]
+#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:<br />[[File:export_po_file.png]]
-#Download and install [http://www.poedit.net/download.php poEDIT] (external link).
+#Download and install [http://www.poedit.net/download.php poEDIT].
 #Start poEdit and edit the downloaded *.po file - modify the particular translations.
 #When you save the *.po file, a *.mo file is automatically created. That is the one LimeSurvey will read from.
-#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. ''Note: The /locale is located inside the root directory of the website.''
+#Place the particular *.mo file in the right language folder in /locale by replacing the existing one.
+{{Note|For example, the location for French would be <LimeSurvey_root_directory>/locale/fr/LC_MESSAGES/fr.po.}}
 #Done.
 <!--T:8-->
-<div class="simplebox"> Note: If you are using LimeService, they will be happy to place the file for you. Just create a support ticket and attach the .po file (not the .mo).</div>
+<div class="simplebox"> Note: If you are using [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Professional], the team will be happy to place the file for you. Just create a [https://www.limesurvey.org/contact-us support ticket] and attach the *.po file (not the .*mo).</div>
 ==Creating a new translation== <!--T:9-->
 #First of all, get access to the development version of LimeSurvey. For detailed instructions, access the following page: [[Accessing the source code]].
-#Download and install [http://www.poedit.net/download.php poEDIT] (external link).
+#Download and install [https://www.poedit.net/download.php poEDIT] .
 #Now you have to find out the language-code for your language - you can search for your language-code in the [https://r12a.github.io/app-subtags/ IANA Language Subtag Registry] (external link).
-#Go to the /locale directory (located in the root directory of the website) and create a directory named after your language code.
+#Go to the /locale directory (located in the LimeSurvey root directory) and create a directory named after your language code.
 #Download your language template by clicking on the following link [https://www.limesurvey.org/limesurvey.pot https://www.limesurvey.org/limesurvey.pot]. Once you receive the language template file, rename it to <your_language_code>.po.
 #Copy the <your_language_code>.po file to the newly created folder located in the /locale directory.
 #Open the file with poEdit and translate everything you need to translate.
-#To make LimeSurvey know about your language, you must add it to the file application/helpers/surveytranslator_helper.php (located in the root directory of the website). Open that file with a text editor and add your language in the same way the other languages in that file are defined.
+#To make LimeSurvey know about your language, you must add it to the file application/helpers/surveytranslator_helper.php (located in the LimeSurvey root directory). Open that file with a text editor and add your language in the same way the other languages in that file are defined.
-#Save - make sure that the *.mo (that's the one LimeSurvey is reading from) file is located near the *.po file. It should be automatically created after you modify the *.po file.
+#Save - in order to allow LimeSurvey to see the newly added language, save the modified *.po file, which will automatically create the *.mo file.
 #Send the new *.po-File and the updated surveytranslator_helper.php file to [mailto:translations@limesurvey.org translations@limesurvey.org]. If you want your name to be linked from/shown on the team page, please write so in the e-mail!
 </translate>

Translating LimeSurvey: Difference between revisions

From LimeSurvey Manual