summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMoritz Sichert <moritz.sichert@googlemail.com>2016-03-13 13:31:11 +0100
committerTim Graham <timograham@gmail.com>2016-03-14 08:42:55 -0400
commit6aef986cdbff72809b39880132959ef74827492f (patch)
tree6332219465b08918ad01d2260db5b8f227f8e58b
parent5695c142d282f4681a8d43bb55ec49f11f3fc40e (diff)
downloaddjango-6aef986cdbff72809b39880132959ef74827492f.tar.gz
Fixed #25804 -- Documented additions to Jinja2 context.
-rw-r--r--docs/topics/templates.txt11
1 files changed, 7 insertions, 4 deletions
diff --git a/docs/topics/templates.txt b/docs/topics/templates.txt
index 3aaa017a25..d905ff38c1 100644
--- a/docs/topics/templates.txt
+++ b/docs/topics/templates.txt
@@ -401,10 +401,13 @@ adds defaults that differ from Jinja2's for a few options:
* ``'auto_reload'``: ``settings.DEBUG``
* ``'undefined'``: ``DebugUndefined if settings.DEBUG else Undefined``
-The default configuration is purposefully kept to a minimum. The ``Jinja2``
-backend doesn't create a Django-flavored environment. It doesn't know about
-Django context processors, filters, and tags. In order to use Django-specific
-APIs, you must configure them into the environment.
+The default configuration is purposefully kept to a minimum. If a template is
+rendered with a request (e.g. when using :py:func:`~django.shortcuts.render`),
+the ``Jinja2`` backend adds the globals ``request``, ``csrf_input``, and
+``csrf_token`` to the context. Apart from that, this backend doesn't create a
+Django-flavored environment. It doesn't know about Django context processors,
+filters, and tags. In order to use Django-specific APIs, you must configure
+them into the environment.
For example, you can create ``myproject/jinja2.py`` with this content::