translationdir.rst

translationdir

Add a :term:`gettext` :term:`translation directory` to the current configuration for use in localization of text.

Attributes

dir

The path to the translation directory. This path may either be 1) absolute (e.g. /foo/bar/baz) 2) Python-package-relative (e.g. packagename:foo/bar/baz) or 3) relative to the package directory in which the ZCML file which contains the directive (e.g. foo/bar/baz).

Example 1

<!-- relative to configure.zcml file -->

<translationdir
  dir="locale"
  />

Example 2

<!-- relative to another package -->

<translationdir
  dir="another.package:locale"
  />

Example 3

<!-- an absolute directory name -->

<translationdir
  dir="/usr/share/locale"
  />

Alternatives

Use :meth:`pyramid.config.Configurator.add_translation_dirs` method instance during initial application setup.

See Also

See also :ref:`activating_translation`.