Explorar o código

Refs #25373 -- Doc'd logging of exceptions during {% include %} rendering.

Tim Graham %!s(int64=9) %!d(string=hai) anos
pai
achega
b1f6046066
Modificáronse 1 ficheiros con 8 adicións e 2 borrados
  1. 8 2
      docs/topics/logging.txt

+ 8 - 2
docs/topics/logging.txt

@@ -490,8 +490,14 @@ Messages to this logger have the following extra context:
 
 .. versionadded:: 1.9
 
-Log messages related to the rendering of templates. Missing context variables
-are logged as ``DEBUG`` messages if :setting:`DEBUG` is `True`.
+Log messages related to the rendering of templates.
+
+* Missing context variables are logged as ``DEBUG`` messages.
+
+* Uncaught exceptions raised during the rendering of an
+  :ttag:`{% include %} <include>` are logged as ``WARNING`` messages when
+  debug mode is off (helpful since ``{% include %}`` silences the exception and
+  returns an empty string in that case).
 
 .. _django-db-logger: