depend on intersphinx to point at Mako i18n recipe

2 files changed, 20 insertions, 5 deletions

diff --git a/docs/conf.py b/docs/conf.py
index dce4ef879..e48af3cbc 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -57,8 +57,24 @@ for item in os.listdir(parent):
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest',
-              'repoze.sphinx.autointerface']
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.doctest',
+    'repoze.sphinx.autointerface',
+    'sphinx.ext.intersphinx'
+    ]
+
+# Looks for objects in other Pyramid projects
+intersphinx_mapping = {
+    'cookbook':
+    ('http://docs.pylonsproject.org/projects/pyramid_cookbook/dev/', None),
+    'handlers':
+    ('http://docs.pylonsproject.org/projects/pyramid_handlers/dev/', None),
+    'zcml':
+    ('http://docs.pylonsproject.org/projects/pyramid_zcml/dev/', None),
+    'jinja2':
+    ('http://docs.pylonsproject.org/projects/pyramid_jinja2/dev/', None),
+    }
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
diff --git a/docs/narr/i18n.rst b/docs/narr/i18n.rst
index 02e7dba64..4871fe400 100644
--- a/docs/narr/i18n.rst
+++ b/docs/narr/i18n.rst
@@ -738,9 +738,8 @@ facility described in :ref:`performing_a_translation`.
 Mako Pyramid I18N Support
 -------------------------
 
-See `Alexandre Bourget's blog entry
-<http://blog.abourget.net/2011/1/13/pyramid-and-mako:-how-to-do-i18n-the-pylons-way/>`_
-to add idiomatic I18N support to :term:`Mako` templates.
+:`mako_i18n` is a cookbook recipe which explains how to add idiomatic I18N
+support to :term:`Mako` templates.
 
 .. index::
    single: localization deployment settings