Changes between Version 16 and Version 17 of UserGuidelines/Localisation


Ignore:
Timestamp:
12/06/10 05:33:48 (11 years ago)
Author:
Michael Howden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UserGuidelines/Localisation

    v16 v17  
    1 = Localisation =
    2 Translation to other languages is highly appreciated - please contact the [http://translate.sahanafoundation.org "Sahana Localization team"] for advice.
     1= UserGuidelines Localisation=
     2[[TOC]]
     3== Contributing to a Translation of Sahana Eden ==
     4Translation to other languages is highly appreciated.[http://pootle.sahanafoundation.org Sahana Pootle Server] is available as on online tool used for Translations.
     5Please see the [UserGuidelinesLocalisationPootle Pootle User Guidelines] for instructions or contact the MailingList for advice.
    36
    4 == Translating Eden to a new language ==
    5 Create language file:
    6  * http://127.0.0.1:8000/admin/default/design/eden#languages
     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}}}
     10Create a new file using the the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1 Code] of the Language.
    711
    8 You can then either edit this in the Web2Py admin UI or else convert to a .po file for use in standard PO file tools such as [http://translate.sourceforge.net/wiki/virtaal/index Virtaal] or Pootle:
     12=== 2. Translate ===
     13Sahana Eden can be translated in the following ways:
     14==== A. Using Pootle ====
     15''Preferred''
     16Convert to a .po file for use in Pootle:
    917 * "web2py2po" scripts (part of the [http://translate.sourceforge.net/wiki/toolkit/py2web2po "Translate Toolkit"])
    1018  * Need to use the [http://eden.sahanafoundation.org/attachment/wiki/UserGuidelinesLocalisation/web2py2po.diff patch] attached to this page (patch against 1.8.0)
    11  * [http://pootle.sahanafoundation.org "Sahana Pootle server"] is available as on online facility for collaboration, translation refinement and workflow control
    12   * PootleHowto
     19 * [http://pootle.sahanafoundation.org Sahana Pootle Server] is available as on online tool for collaboration, translation refinement and workflow control. See the [UserGuidelinesLocalisationPootle Pootle User Guidelines] for instructions.
    1320
    1421For UTF-8, beware of the encoding - needs to be 'without BOM' or 'ANSI as UTF-8'.[[BR]]
    15 - this is both within the {{{languages/}}} file & also with any UTF-8 direct in customised Views.
     22- this is both within the {{{languages/}}} file & also with any UTF-8 direct in customised Views.[[BR]]
     23
     24You can also use standard PO file tools such as [http://translate.sourceforge.net/wiki/virtaal/index Virtaal].[[BR]]
    1625
    1726{{{
    1827web2py2po -i zh-tw.py -o zh-tw.po
    1928
    20 # Use Virtaal &/or Pootle to translate
     29# Use Pootle &/or Virtaal to translate
    2130
    2231po2web2py -i zh-tw.po -o zh-tw.py
    2332}}}
    2433
     34==== B. Using Auto-Translator ====
    2535You can -also- try a new method, using a beta tool, which translates any file (including the web2py languages files) using the Google Translate API:
    2636 * Go to [http://pypi.python.org/pypi/auto-translator/ "Auto-Translator"], download, uncompress the .tar.gz archive
     
    3646   Please provide any bug report or problem to the main list
    3747
    38 == Wiki pages translation ==
    39  * translated pages with ISO 639-2 language code extension (original english page = no extension), e.g.
     48==== C. Using Web2Py Admin UI  ====
     49You can then edit the language file directly in the Web2Py Admin UI.
     50
     51== Translate Wiki Pages ==
     52 * 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.
    4053   * '''original page:''' eden.sahanafoundation.org/wiki/BluePrintInternationalisation
    4154   * '''german translation:''' eden.sahanafoundation.org/wiki/BluePrintInternationalisation'''/de'''
    4255
    43  * insert ![[TranslatedPages]] macro to display a list of available translations of a page (at best at bottom of page)
     56 * Insert ![[TranslatedPages]] macro to display a list of available translations of a page (at best at bottom of page)
    4457
    4558== See Also ==