diff options
author | Moritz Sichert <moritz.sichert@googlemail.com> | 2016-03-13 13:31:11 +0100 |
---|---|---|
committer | Tim Graham <timograham@gmail.com> | 2016-03-14 08:42:55 -0400 |
commit | 6aef986cdbff72809b39880132959ef74827492f (patch) | |
tree | 6332219465b08918ad01d2260db5b8f227f8e58b | |
parent | 5695c142d282f4681a8d43bb55ec49f11f3fc40e (diff) | |
download | django-6aef986cdbff72809b39880132959ef74827492f.tar.gz |
Fixed #25804 -- Documented additions to Jinja2 context.
-rw-r--r-- | docs/topics/templates.txt | 11 |
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:: |