From 5a0e39b2d5a0807bd25e17ac9eb1fd9165da6d55 Mon Sep 17 00:00:00 2001 From: Andrei Kulakov Date: Mon, 18 May 2015 17:13:16 -0400 Subject: [PATCH] [1.8.x] Fixed #24813 -- Documented {% include %} debug behavior variance Backport of fc3409b0932959f2aca42715e9147113d0e40f79 from master --- docs/ref/templates/builtins.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index b1d24c8c09..aa7b4dd0ee 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -695,6 +695,15 @@ available to the included template:: {% include "name_snippet.html" with greeting="Hi" only %} +If the included template causes an exception while it's rendered (including +if it's missing or has syntax errors), the behavior varies depending on the +:class:`template engine's ` ``debug`` option (if not +set, this option defaults to the value of :setting:`DEBUG`). When debug mode is +turned on, an exception like :exc:`~django.template.TemplateDoesNotExist` or +:exc:`~django.template.TemplateSyntaxError` will be raised; otherwise +``{% include %}`` silences any exception that happens while rendering the +included template and returns an empty string. + .. note:: The :ttag:`include` tag should be considered as an implementation of "render this subtemplate and include the HTML", not as "parse this