Translation documentation for Developers: Difference between revisions

From OpenPetra Wiki
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Documentation for Translators =
= Documentation for Translators =
There is a separate page with [[Documentation for Translators]].
There is a separate page with [[Documentation for Translators]].
= The translation process =
There are actually 3 different ways to provide some translation.
== Using Weblate for translation ==
Using the [https://weblate.openpetra.org Weblate]. To be able to make changes on the translation a registration is needed. If you are not sure with a translation please check "Fuzzy".
== Using Poedit for translation ==
Using poedit: The following steps are needed.
* Download Poedit. The Version 1.8.4 is available [https://github.com/vslavik/poedit/releases at Github]
* Download the .po-file (not .mo!!) . For Spanish it is available [https://weblate.openpetra.org/download/openpetra/openpetra/es/ here]
* Edit the .po-file offline
* Upload it again [https://weblate.openpetra.org/projects/openpetra/openpetra/es/#upload here] (for Spanish). You will need to have an account on weblate.openpetra.org.
Poedit allows working faster than the first alternative. In order to avoid that work is done double by several translators please contact the translation team before starting: [mailto:joejoe2010(at)users.sourceforge.net joejoe2010@users.sourceforge.net]
== Using Excel or LibreOffice Calc for translation ==
Converting the po-file to csv and open it eg. with Microsoft Excel:
This might be the easiest way to provide the items for translators which are not familiar with 1.) or 2.)
Please follow these steps:
* Download the latest version of toolkit [http://sourceforge.net/projects/translate/files/Translate%20Toolkit/ from Sourceforge]. The file should be named translate-toolkit-…-setup.exe.
* Install toolkit
* Open a windows command line (Win+R) and adapt your path: for example with PATH=%PATH%;E:\Program Files\Translate Toolkit
* Download the actual .po-file (not .mo!!) . It is available [https://weblate.openpetra.org/download/openpetra/openpetra/es/ here] (for Spanish).
* On the windows command line, move to the folder where the file is saved
* Execute po2csv. For example po2csv template1_template1-es.po template1_template1-es.csv --progress=verbose --errorlevel=message
* eventually: save the csv as xls
* provide the csv or xls-file to your translators
* when you get it back you need to save the file as csv (using UTF-8); this is especially necessary for ú, é etc used eg. in Spanish
* Execute csv2po. For example csv2po template1_template1-es.csv template1_template1-es_rückkonvertiert.po --progress=verbose --errorlevel=message
* Upload the po-file [https://weblate.openpetra.org/projects/openpetra/openpetra/es/#upload here] (for Spanish). You will need to have an account on weblate.openpetra.org.
In order to avoid that work is done double by several translators please contact the translation team before starting: [mailto:joejoe2010(at)users.sourceforge.net joejoe2010@users.sourceforge.net]


= Testing a translation =
= Testing a translation =
We provide a Nightly Build of OpenPetra. This integrates the changes on Github that has been made on the last 24 hours.
You can get a test installation, by running
You can get the Nightly Build [https://lbs.solidcharity.com/package/tpokorra/openpetra/openpetranow-standalone-nightly here]. Please download the exe-file OpenPetraSetup-x.x.xx.xxxx.exe and install it on your computer to see your new translations.
 
= Update translation template =
The synchronisation process needs to be done by someone of the Core development team. The goal is to update the template on Weblate with new strings to translate.
 
Make sure that you have pushed all changes on Weblate to our [https://github.com/openpetra/openpetra-i18n Github repository for the translations], at https://weblate.openpetra.org/projects/openpetra/openpetra/#repository.
The next steps have been automated with the command <code>nant buildTranslationTemplate</code>.
 
This command will:
* Download the latest translations from Github (https://github.com/openpetra/openpetra-i18n)
* Will create a new template.pot file
* Will update the existing .po files


You should commit the updated template.pot and the updated .po files to https://github.com/openpetra/openpetra-i18n again, and make sure you do a pull on Weblate, and then a reset, losing all local changes, but getting all new strings
curl https://get.openpetra.org | bash -s test


All .po files in the i18n directory will be added to the installer automatically. OpenPetra will use the language settings on the workstation for determining which language file should be used.
Then just replace your language file in /home/op_test/client/locales, and reload your browser.


= Reviewing the translation template =
= Reviewing the translation template =
Please have a look at [[Reviewing the translation template]]
Please have a look at [[Reviewing the translation template]]

Latest revision as of 06:16, 26 March 2020

Documentation for Translators

There is a separate page with Documentation for Translators.

Testing a translation

You can get a test installation, by running

curl https://get.openpetra.org | bash -s test

Then just replace your language file in /home/op_test/client/locales, and reload your browser.

Reviewing the translation template

Please have a look at Reviewing the translation template