| | 1 | = User Guidelines - Localisation - Pootle = |
| | 2 | |
| | 3 | Here shows an example how Taiwan team uses [http://pootle.sahanafoundation.org/ Sahana Pootle Server] in the language translation process. In the following example, zh-tw.py is used, but the main idea should apply to other teams. |
| | 4 | |
| | 5 | Roughly there are two roles: |
| | 6 | |
| | 7 | 1. Translator who focuses on term translation and polishing, not necessary to know how .py files work. |
| | 8 | |
| | 9 | 2. Administrator who converts updated .po to .py, and makes it works in eden/languages directory. If you are an Administrator, be sure to see the useful UserGuidelinesLocalisation before using Pootle or other translation tools. |
| | 10 | |
| | 11 | == As a Translator, How to Translate Terms on Pootle == |
| | 12 | |
| | 13 | 1. Say, we want to translate a term "Required Field", use search form to find it. |
| | 14 | |
| | 15 | [[Image(search-term.png)]] |
| | 16 | |
| | 17 | 2. Put the translation in the field below the term. |
| | 18 | You can submit the translation, or assign it as a suggestion. |
| | 19 | |
| | 20 | [[Image(chinese-term.png)]] |
| | 21 | |
| | 22 | 3. If there are other terms matching "Required Field", they will be shown afterward. |
| | 23 | |
| | 24 | == As an Administrator, How to Apply New PO into Eden == |
| | 25 | |
| | 26 | 1. Go to "Translate" tab. |
| | 27 | |
| | 28 | 2. You can download via "ZIP of directory". A file name like "eden-zh_TW.zip" will be saved. Unzip the file will give you zh-tw.py. |
| | 29 | |
| | 30 | [[Image(download.png)]] |
| | 31 | |
| | 32 | 3. Run "po2web2py -i zh-tw.po -o zh-tw.py" to generate the needed language file. |
| | 33 | |
| | 34 | 4. Place the generated zh-tw.py in the eden/languages directory, and see if everything goes as expected. |
| | 35 | |
| | 36 | == As an Administrator, How to Apply New PO into Pootle == |
| | 37 | |
| | 38 | A common case is that you have a new zh-tw.py in languages directory, and want to upload it to pootle. This zh-tw.py file can turn into zh-tw.po running "web2py2po -i zh-tw.py -o zh-tw.po". |
| | 39 | |
| | 40 | marr's note: in my experience, with the above generated zh-tw.po file, you might see all msgstr filled with strings automatically, and uploading such file to pootle will mislead the statistics. |
| | 41 | |
| | 42 | 1. Go to "Translate" tab. |
| | 43 | |
| | 44 | 2. Choose the .po file to upload. Say, you can "Overwrite the current file if it exists". |
| | 45 | |
| | 46 | 3. If choosing "Add all new translations as suggestions", or, there are suggestions for a term, you can decide "Accept" or "Reject" them. |
