Documentation for Translators: Difference between revisions

From OpenPetra Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by the same user not shown)
Line 8: Line 8:
''You are very welcome to help in translating OpenPetra into other languages.''
''You are very welcome to help in translating OpenPetra into other languages.''


==Ways of Translating OpenPetra==
==Translation team==
There are three different ways to provide some translation.


The first one is the easiest and is described in the following paragraphs. The other two options can be found on the page [[Translation_documentation_for_Developers | Translation documentation for Developers]].
If you have questions or doubts feel free to post on the [https://forum.openpetra.org Forum]


If you have questions or doubts feel free to contact the translation team: [mailto:joejoe2010@users.sourceforge.net joejoe2010(at)users.sourceforge.net]
== How to translate ==
We are using Weblate for managing the translations of the javascript client.


== How to translate with Weblate ==
Just go to https://weblate.openpetra.org to our own Weblate installation.
Weblate is a platform for making the process of translating easier.
You can find the openpetra project [https://weblate.openpetra.org/projects/openpetra/openpetra/ here]. Please click on the language for which you want to provide more translations.
In order to make changes on a translation a registration is needed. You can register [https://weblate.openpetra.org/accounts/register/ here].
If you are not sure with a translation please check "Fuzzy" so that another person can review the item later on.


== Using Poedit for translation ==
== Testing the translations ==
Using poedit: The following steps are needed.
You can get a test installation, by running
 
* 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.
curl https://get.openpetra.org | bash -s test


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]
Then just replace your language file in /home/op_test/client/locales, and reload your browser.
 
== 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 the translations ==
We provide a Nightly Build of OpenPetra. This provides the changes on Weblate that has been made on the day before. You can get the Nightly Build for Windows from our [https://lbs.solidcharity.com/package/tpokorra/openpetra/openpetranow-standalone-nightly Build server]. Please download the exe-file OpenPetraSetup-x.x.xx.xxxx.exe and install it on your computer to see your new translations.


== Language specific information ==
== Language specific information ==

Latest revision as of 08:03, 19 Mayıs 2022

General Information

The team behind OpenPetra doesn't plan particular translations of OpenPetra - rather, the OpenPetra application can be translated voluntarily by people who want to either contribute to OpenPetra with their skills in this way and/or have a particular interest in having the application in their 'heart language'.

  • The people who do the translation should be good in English and translate the application out of English into their mother tongue, but they don’t need to be computer specialists for that!
  • One doesn't need to take on the task of translating the whole application into another language as the translations are done incrementally - sentence for sentence.
  • One can translate as much or as little as he desires, and one doesn't even need to notify us if he/she starts translating, though it would be kind if that would be done.

You are very welcome to help in translating OpenPetra into other languages.

Translation team

If you have questions or doubts feel free to post on the Forum

How to translate

We are using Weblate for managing the translations of the javascript client.

Just go to https://weblate.openpetra.org to our own Weblate installation.

Testing the translations

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.

Language specific information

Translation documentation for Developers