add documentation for babel configuration

ewheeler · ewheeler · commit d1e48fb78162 · 2012-10-02T14:10:22.000-04:00
diff --git a/docs/index.rst b/docs/index.rst
@@ -144,6 +144,27 @@ configuration. The following two statements are equivalent:
 For a list of available settings, see the full
 :ref:`webassets documentation <webassets:environment-configuration>`.
 
+Babel Configuration
+~~~~~~~~~~~~~~~~~~~
+
+If you use `Babel`_ for internationalization, then you will need to
+add the extension to your babel configuration file
+as ``webassets.ext.jinja2.AssetsExtension``
+
+Otherwise, babel will not extract strings from any templates that
+include an ``assets`` tag.
+
+Here is an example ``babel.cfg``:
+
+.. code-block:: python
+
+    [python: **.py]
+    [jinja2: **.html]
+    extensions=jinja2.ext.autoescape,jinja2.ext.with_,webassets.ext.jinja2.AssetsExtension
+
+
+.. _Babel: http://babel.edgewall.org/
+
 
 Management Command
 ------------------
