= Localisation =
Translation to other languages is highly appreciated - please contact the [http://translate.sahanafoundation.org "Sahana Localization team"] for advice.

== Translating Eden to a new language ==
Create language file:
 * http://127.0.0.1:8000/admin/default/design/eden#languages

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]:
 * [http://pub.nursix.org/translate/web2py2po.tar.gz "web2py2po"] scripts (part of the [http://translate.sourceforge.net/wiki/toolkit/py2web2po "Translate Toolkit"])

For UTF-8, beware of the encoding - needs to be 'without BOM' or 'ANSI as UTF-8'.[[BR]]
- this is both within the {{{languages/}}} file & also with any UTF-8 direct in customised Views.

{{{
web2py2po -i zh-tw.py -o zh-tw_raw.po
pofilter -i zh-tw_raw.po -o zh-tw_unchanged.po -t unchanged
pomerge -i zh-tw_unchanged.po -o zh-tw.po -t zh-tw_raw.po

# Use Virtaal &/or Pootle to translate 

po2web2py -i zh-tw.po -o zh-tw.py
}}}

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:
 * Go to [http://pypi.python.org/pypi/auto-translator/ "Auto-Translator"], download, uncompress the .tar.gz archive
 * Inside the uncompressed directory, execute the application with:
   - ./autotranslate.py (parameters)
   or
   - python autotranslate.py (parameters)

   (The parameters are: '''filename, origin language and destination language''')[[BR]]
   Example: ./autotranslate.py /home/johndoe/web2py/applications/eden/languages/es.py en es [[BR]]
   Wait (you'll see an advance status) and DONE.  Just refine the translations (inside web2py or just open with a text editor)[[BR]]
   [[BR]]
   Please provide any bug report or problem to the main list


=== Pootle/translate toolkit ===
 * [http://pootle.sahanafoundation.org "Sahana Pootle server"] is available as on online facility for collaboration, translation refinement and workflow control

== Wiki pages translation ==
 * translated pages with ISO 639-2 language code extension (original english page = no extension), e.g.
   * '''original page:''' eden.sahanafoundation.org/wiki/BluePrintInternationalisation
   * '''german translation:''' eden.sahanafoundation.org/wiki/BluePrintInternationalisation'''/de'''

 * insert ![[TranslatedPages]] macro to display a list of available translations of a page (at best at bottom of page)

== See Also ==
 * DeveloperGuidelinesInternationalisation
 * BluePrintInternationalisation
----
UserGuidelines