Changes between Version 40 and Version 41 of UserGuidelines/Localisation


Ignore:
Timestamp:
10/23/14 14:06:10 (7 years ago)
Author:
Fran Boon
Comment:

Rework page

Legend:

Unmodified
Added
Removed
Modified
  • UserGuidelines/Localisation

    v40 v41  
    22[[TOC]]
    33== Contributing to a Translation of Sahana Eden ==
    4 Translation to other languages is highly appreciated.[http://pootle.sahanafoundation.org Sahana Pootle Server] is available as on online tool used for Translations.
     4Translation to other languages is highly appreciated.
     5
     6It would also be great to have someone volunteer to be our Translations lead / coordinator.
     7
     8== Web2Py Localisation System ==
     9Sahana Eden is built using Web2Py & as-such it inherits the Web2Py localisation architecture:
     10* http://www.web2py.com/books/default/chapter/29/04/the-core#Internationalization--and-Pluralization-with-T
     11
     12NB Currently Sahana is NOT using the pluralisation functionality (help migrating to that would be appreciated!)
     13
     14Current languages translated to some extent:
     15* https://github.com/flavour/eden/tree/master/languages
     16
     17== Translation Tools ==
     18=== Sahana Translation Interface ===
     19We have built our own Translation module which allows you to export the *relevant* strings to an .xls file, a .po file or upload to Pootle:
     20* http://host.domain/eden/admin/translate
     21
     22It also supports uploading updated [partial] files to be merged with the existing {{{languages/code.py}}}
     23
     24If the language you want isn't yet available, then create a new file using the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1 Code] of the Language as the filename. If it is a national variation of a language, eg. New Zealand English, add a suffix to the filename: "en_nz.py".
     25
     26=== Pootle ===
     27We maintain a [http://pootle.sahanafoundation.org Pootle Server] as a collaborative space to both do the initial translations and also to allow people to suggest improvements.
     28
    529Please see the [UserGuidelinesLocalisationPootle Pootle User Guidelines] for instructions or contact the MailingList for advice.
    6 
    7 == Translate Sahana Eden into a New Language ==
    8 === 1. Create Language File ===
    9 http://127.0.0.1:8000/admin/default/design/eden#languages
    10 
    11 Create a new file using the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1 Code] of the Language as the filename. If it is a national variation of a language, eg. New Zealand English, add a suffix to the filename: "en_nz.py".
    12 
    13 === 2. Translate ===
    14 Sahana Eden can be translated in the following ways:
    15 
    16 ==== A. Using Pootle ====
    17 ''Preferred method''
    18 
    19 [http://pootle.sahanafoundation.org Sahana Pootle Server] is available as on online tool for collaboration, translation refinement and workflow control.
    20  * [UserGuidelinesLocalisationPootle Pootle User Guidelines]
    2130
    2231Convert to a .po file for use in Pootle (or other PO file tools such as [http://translate.sourceforge.net/wiki/virtaal/index Virtaal]):
     
    4453See SysAdmin/Pootle
    4554
    46 ==== B. Using Eden Admin UI  ====
    47 You can export the strings to an .xls file, a .po file or upload to Pootle
     55=== Transifex ===
     56We are also starting to try out [https://www.transifex.com/organization/sahana Transifex] to do the same job as Pootle, so if you prefer to use that then we can support you there too.
    4857
    49  * http://127.0.0.1:8000/admin/translate
    50 
    51 ==== C. Using Web2Py Admin UI  ====
    52 You can then edit the language file directly in the Web2Py Admin UI.
     58=== Web2Py Admin UI  ===
     59You can edit the language file directly in the Web2Py Admin UI.
    5360
    5461If wishing to provide access to just language strings & not the rest of the source code:
     
    6168}}}
    6269
    63 ==== D. Using Auto-Translator ====
    64 You can -also- try a new method, using a beta tool, which translates any file (including the web2py languages files) using the Google Translate API:
     70=== Using Auto-Translator ===
     71You can -also- try a beta tool, which translates any file (including the web2py languages files) using the Google Translate API:
    6572 * Go to [http://pypi.python.org/pypi/auto-translator/ "Auto-Translator"], download, uncompress the .tar.gz archive
    6673 * Inside the uncompressed directory, execute the application with:
     
    7885To remove rows where source & target are the same, can create a new column with =IF(A2=B2;1;0), Paste Special, Sort & Delete 1s
    7986
     87* http://stackoverflow.com/questions/6002256/is-it-possible-to-force-excel-recognize-utf-8-csv-files-automatically
     88 1. Save the exported file as a csv
     89 1. Open Excel
     90 1. Import the data using Data-->Import External Data --> Import Data
     91 1. Select the file type of "csv" and browse to your file
     92 1. In the import wizard change the File_Origin to "65001 UTF" (or choose correct language character identifier)
     93 1. Change the Delimiter to comma
     94 1. Select where to import to and Finish
     95
    8096== Translate Wiki Pages ==
    8197* Translated pages with [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-2 Language Code] extension (original english page = no extension), e.g.
     
    88104* DeveloperGuidelines/Internationalisation
    89105* BluePrint/Internationalisation
    90 * http://stackoverflow.com/questions/6002256/is-it-possible-to-force-excel-recognize-utf-8-csv-files-automatically
    91  1. Save the exported file as a csv
    92  1. Open Excel
    93  1. Import the data using Data-->Import External Data --> Import Data
    94  1. Select the file type of "csv" and browse to your file
    95  1. In the import wizard change the File_Origin to "65001 UTF" (or choose correct language character identifier)
    96  1. Change the Delimiter to comma
    97  1. Select where to import to and Finish