1 files changed, 66 insertions, 0 deletions
diff --git a/docs/zcml/translationdir.rst b/docs/zcml/translationdir.rst
new file mode 100644
index 000000000..5c69cb737
--- /dev/null
+++ b/docs/zcml/translationdir.rst
@@ -0,0 +1,66 @@
+.. _translationdir_directive:
+
+``translationdir``
+------------------
+
+Add a :term:`gettext` :term:`translation directory` to the current
+configuration for use in localization of text.
+
+.. note:  This ZCML directive is new as of :mod:`repoze.bfg` version 1.3.
+
+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
+~~~~~~~~~
+
+.. code-block:: xml
+   :linenos:
+
+   <!-- relative to configure.zcml file -->
+
+   <translationdir
+     dir="locale"
+     />
+
+Example 2
+~~~~~~~~~
+
+.. code-block:: xml
+   :linenos:
+
+   <!-- relative to another package -->
+
+   <translationdir
+     dir="another.package:locale"
+     />
+
+Example 3
+~~~~~~~~~
+
+.. code-block:: xml
+   :linenos:
+
+   <!-- an absolute directory name -->
+
+   <translationdir
+     dir="/usr/share/locale"
+     />
+
+Alternatives
+~~~~~~~~~~~~
+
+Use :meth:`repoze.bfg.configuration.Configurator.add_translation_dirs`
+method instance during initial application setup.
+
+See Also
+~~~~~~~~
+
+See also :ref:`activating_translation`.