File: chameleon.rst

package info (click to toggle)
python-translationstring 1.4-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid, trixie
  • size: 248 kB
  • sloc: python: 797; makefile: 70
file content (27 lines) | stat: -rw-r--r-- 1,081 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Chameleon Translate Function Support
====================================

:func:`translationstring.ChameleonTranslate` is a function which
returns a callable suitable for use as the ``translate`` argument to
various ``PageTemplate*`` constructors.

.. code-block:: python
   :linenos:

   from chameleon.zpt.template import PageTemplate
   from translationstring import ChameleonTranslate
   from translationstring import Translator
   import gettext

   translations = gettext.translations(...)
   translator = Translator(translations)
   translate = ChameleonTranslate(translate)
   pt = PageTemplate('<html></html>', translate=translate)

The ``translator`` provided should be a callable which accepts a
single argument ``translation_string`` ( a
:class:`translationstring.TranslationString` instance) which returns a
``unicode`` object as a translation; usually the result of calling
:func:`translationstring.Translator`.  ``translator`` may also
optionally be ``None``, in which case no translation is performed (the
``msgid`` or ``default`` value is returned untranslated).