Changes between Version 2 and Version 3 of UserGuidelinesLocalisationPootle


Ignore:
Timestamp:
12/06/10 09:50:02 (14 years ago)
Author:
Michael Howden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • UserGuidelinesLocalisationPootle

    v2 v3  
    22[[TOC]]
    33
    4 The [http://pootle.sahanafoundation.org Sahana Pootle Server] is available
    5 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.
     4The [http://pootle.sahanafoundation.org Sahana Pootle Server] is a tool to assist with translations. If you have any queries or need permission, please contact the MailingList.
    65
    7 Roughly there are two roles:
     6This is based on 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.
    87
    9  1. Translator who focuses on term translation and polishing, not necessary to know how .py files work.
     8There are two main roles:
    109
     10 1. Translator who focuses on text translation. This role doesn't need technical ability.
    1111 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.
    1212
    13 == Translate Terms ==
     13== Translate Text ==
    1414
    15  1. Say, we want to translate a term "Required Field", use search form to find it.
     15 1. Select the project (typically "Sahana Eden") and the language you wish to translate into.
     16
     17 2. To translate a term, either:
     18  a. Search for a term eg. "Required Field".
    1619
    1720[[Image(search-term.png)]]
     21  b. Click on the {{{Translate}}} Tab and select {{{Quick Translate}}} or {{{Translate All}}}.
    1822
    19  2. Put the translation in the field below the term.
     23 3. Put the translation in the field below the term.
    2024    You can submit the translation, or assign it as a suggestion.
    2125
    2226[[Image(chinese-term.png)]]
    2327
    24  3. If there are other terms matching "Required Field", they will be shown afterward.
     28 4. If there are other terms matching the translated text, eg. "Required Field", they will be shown afterward.
    2529
    26 == As an Administrator, How to Apply New PO into Eden ==
     30== Apply a Translated Language to Sahana Eden ==
    2731
    28  1. Go to "Translate" tab.
     32 1. Select the project "Sahana Eden" and the language you wish to apply the translation for.
    2933
    30  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.
     34 2. Go to "Translate" tab.
     35
     36 3. Download the language .po (eg. zh-tw.pyo)file by clicking on the "Download" link. You may have save the page that opens.
    3137
    3238[[Image(download.png)]]
    3339
    34  3. Run "po2web2py -i zh-tw.po -o zh-tw.py" to generate the needed language file.
     40 4. Run "po2web2py -i zh-tw.po -o zh-tw.py" to generate the needed language file.
    3541
    36  4. Place the generated zh-tw.py in the eden/languages directory, and see if everything goes as expected.
     42 5. Place the generated zh-tw.py in the eden/languages directory.
    3743
    38 == As an Administrator, How to Apply New PO into Pootle ==
     44 6. Edit {{{deployment_settings.L10n.languages}}} in {{{models/000_config.py}}}
    3945
    40 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".
     46== Update the Language File in Pootle ==
     47''Administrator Only''
     48
     49A 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". See: [UserGuidelinesLocalisation#A.UsingPootle User Guidelines Localisation]
    4150
    4251marr'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.
    4352
    44  1. Go to "Translate" tab.
     53 1. Select the project "Sahana Eden" and the language you wish to apply the translation for.
    4554
    46  2. Choose the .po file to upload. Say, you can "Overwrite the current file if it exists".
     55 2. Go to "Translate" tab.
    4756
    48  3. If choosing "Add all new translations as suggestions", or, there are suggestions for a term, you can decide "Accept" or "Reject" them.
     57 3. Choose the .po file to upload. Say, you can "Overwrite the current file if it exists".
     58
     59 4. If choosing "Add all new translations as suggestions", or, there are suggestions for a term, you can decide "Accept" or "Reject" them.
     60
     61
     62== Add a New Language to Pootle ==
     63''Administrator Only''
     64
     65 1. Admin (top right) -> Languages. Add Language (to Pootle).
     66 1. Select Project ("Sahana Eden") -> Administrate. Add Language (to Project).
     67 1. Select  Project ("Sahana Eden") -> <New Language>. Upload *.po file. See: [UserGuidelinesLocalisation#A.UsingPootle User Guidelines Localisation]
     68