anchor.diff:  link:http://jinja.pocoo.org/docs/api/#bytecode-cache[More documentation about bytecode cache]
   
   
  -Differences
  -~~~~~~~~~~~
  +=== Configure for django +++>=+++ 1.8
  +
  +Django 1.8 introduces multiple template engine and new way to configure them.
  +
  +This is a quick example of how to configure _django-jinja_ with django 1.8 configuration
  +formata:
  +
  +[source, python]
  +----
  +TEMPLATES = [
  +    {
  +        "BACKEND": "django.template.backends.django.DjangoTemplates",
  +        "DIRS": [],
  +        "APP_DIRS": True
  +    },
  +    {
  +        "BACKEND": "django_jinja.backend.Jinja2",
  +        "APP_DIRS": True,
  +        "OPTIONS": {
  +            "match_extension", ".jinja",
  +        }
  +    },
  +]
  +----
  +
  +_django-jinja_ backend, unlike django's one, uses the "templates" directory and works like a middleware.
  +It intercepts by extension or by regular expression.
  +
  +
  +Full list of options, almost all them not mandatory:
  +
  +[source, python]
  +----
  +TEMPLATES = [
  +    {
  +        "BACKEND": "django_jinja.backend.Jinja2",
  +        "APP_DIRS": True,
  +        "OPTIONS": {
  +            "match_extension": ".jinja",
  +            "match_regex": r"^(?!admin/).*", # this is exclusive with match_extension
  +            "context_processors": [
  +                "django.contrib.auth.context_processors.auth",
  +                "django.template.context_processors.debug",
  +                "django.template.context_processors.i18n",
  +                "django.template.context_processors.media",
  +                "django.template.context_processors.static",
  +                "django.template.context_processors.tz",
  +                "django.contrib.messages.context_processors.messages",
  +            ],
  +            "extensions": [
  +                "jinja2.ext.do",
  +                "jinja2.ext.loopcontrols",
  +                "jinja2.ext.with_",
  +                "jinja2.ext.i18n",
  +                "jinja2.ext.autoescape",
  +            ],
  +            "newstyle_gettext": True,
  +            "environment": "jinja2.Environment",
  +            "auto_reload": settings.DEBUG
  +        }
  +    }
  +]
  +----
  +
  +All other options are passed directly to environment constructor.
  +
  +
  +=== Differences
   
   .Reverse urls in templates
   [source, html+jinja]
  
positive.code: DEFAULT_JINJA2_TEMPLATE_EXTENSION = '.jinja'
  ----
  
  With this settings, django-jinja intercepts all templates with `.jinja` extension and render them with jinja2
  engine and templates that not matches the `.jinja` extension are forwarded to django templates engine.
  
  
  Additionaly, *django-jinja* exposes, more advanced matcher, using regular exceptions:
  
  
negative.code: pip install django-jinja
  ----
  
  Add add it to django installed apps list:
  
  [source, python]
  ----
  INSTALLED_APPS += ('django_jinja',)
  ----
  
  === Configure for django +++<=+++ 1.7
  
  The first step for configure _django-jinja_ is replace default
  django template loaders:
  