Translation

pantra supports internationalization and localization powered by Babel

Region and language specification

pantra gets language information from HTTP header, usually filled by Web browser:

Accept-Language: ru-RU,ru;q=0.9,en-US;q=0.8,en;q=0.7

Otherwise, pantra uses DEFAULT_LANGUAGE option as fallback language.

What is translated?

To perform content translation to different languages this content should be marked by special way.

• Components text content prefixed with #:

  <div>#Hello world!</div>
  

• String value within python code in component with _ function (alias to pantra.session.Session.zgettext()):

  <div>!{{message}}</div>
  <python>
  message: str
  def action(node):
      ctx['message'] = _("Hello there!")
  </python>
  

• All database tables names and related attributes names from app/data/__init__.py. No special mark needed.

Language files location

Regarding to directory structure “locales” are located in:

• apps/app_name/locale/locale_name/LC_MESSAGES/messages.po - for applications

• components/locale/locale_name/LC_MESSAGES/messages.po - for common components

Extract and compile

To extract and compile string data use command:

$ pantra locale.gen

See also

Read more about command line here.