Překlad LimeSurvey

Translating LimeSurvey

Nebylo by skvělé nechat LimeSurvey kompletně přeložit do vašeho rodného jazyka? Tým LimeSurvey vždy hledá nové překlady a lidi, kteří pomáhají aktualizovat ty stávající. Přečtěte si prosím tyto pokyny a neváhejte a pošlete e-mail na translations@limesurvey.org, pokud máte pochybnosti nebo máte nějaké další otázky.

Jak přeložit - pokyny krok za krokem

Aktualizace existujícího překladu

1. Zaregistrujte se na webu LimeSurvey a poté se přihlaste na svůj účet.
2. Přejděte na https://translate.limesurvey.org a přihlaste se tam pomocí stejného uživatelského jména a hesla.
3. Vyberte verzi LimeSurvey, kterou chcete přeložit, a prostě začít. Po schválení vašeho překladu bude automaticky zahrnut do týdenního stabilního vydání a vaše uživatelské jméno bude uvedeno v protokolu změn.
4. Pokud máte zájem stát se hlavním překladatelem pro váš jazyk s možností schvalovat nově přeložené strings, kontaktujte nás prosím na translations@limsurvey.org. Taková pozice vyžaduje maximálně asi hodinu práce týdně – je pro nás důležité, abyste v tom byli spolehliví.

Přizpůsobte existující překlad

Někdy možná budete chtít upravit stávající překlad, aby lépe vyhovoval vaší konkrétní situaci v průzkumu. V takovém případě proveďte následující:

1. Přejděte na https://translate.limesurvey.org, vyberte verzi LimeSurvey, kterou chcete přeložit, a konkrétní jazyk, který chcete přeložit upravit.
2. Ve spodní části stránky překladu najdete možnost exportovat všechny řetězce jako soubor *.po. Klikněte na export a uložte jej jako soubor *.po na místní pevný disk:
   
3. Stáhněte a nainstalujte Poedit.
4. Spusťte aplikaci Poedit a upravte stažený soubor *.po – upravte konkrétní překlady.
5. Když uložíte soubor *.po, automaticky se vytvoří soubor *.mo. Ten bude číst LimeSurvey.
6. Posledním krokem je umístění konkrétního *.mo souboru do správné jazykové složky v /locale nahrazením stávajícího.

Poznámka: Pokud používáte LimeSurvey Pro (pouze pro uživatele Cooperate a Enterprise), tým bude rádi za vás umístíme soubor. Stačí vytvořit lístek podpory a připojit soubor *.po ( ne .*mo ).

Creating a new translation

1. First of all, get access to the development version of LimeSurvey. For detailed instructions, access 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 into the /locale directory (located in the LimeSurvey root directory) and create a directory named after your language code.
5. Download your language template by going to on the following link [1]. Select the project, then any language (e.g. go for the English entry), and scroll to the bottom. There you have the possibility to export the language file as <your_language_code>.po file.
6. Copy the <your_language_code>.po file to the newly created folder located in the /locale directory.
7. Open the file with Poedit and translate everything you need to translate.
8. To make LimeSurvey know about your language, you must add it in 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 are defined in that file.
9. Save - in order to allow LimeSurvey to see the newly added language, save the modified *.po file. This will automatically generate the *.mo file in the same folder, which will be read by LimeSurvey.
10. Send the new *.po file and the updated surveytranslator_helper.php file to translations@limesurvey.org.

If your language use a lot of special character : please check what font must be used for pdf generation (check with dejavusans for example). Then we can add this font file in alternatepdffontfile default configuration.

If you want your name to be linked from/shown on the team page, please write so in the email!

Sample code for add a new language

    $supportedLanguages['code']['description'] = gT('Language'); // Your language name in English
    $supportedLanguages['code']['nativedescription'] = 'Language in native';  // The native name of your language
    $supportedLanguages['code']['rtl'] = (true|false); // RTL 
    $supportedLanguages['code']['dateformat'] = integer; // See getDateFormatData function
    $supportedLanguages['code']['radixpoint'] = (0|1); // 0 : ., 1 : , for radix point
    $supportedLanguages['code']['cldr'] = 'code';  // If the related Yii language code differs you can here map your language to a new code
    $supportedLanguages['code']['momentjs'] = 'code'; // Used by moment.js

Other part to be translated

• LimeSurvey use moment.js. When you send the message to translations@limesurvey.org check what language code must be used.

• moment.js : method to contribute to moment.js translation are explained at moment.js documentation.