Przeglądaj źródła

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

Tim Graham 9 lat temu
rodzic
commit
b1f6046066
1 zmienionych plików z 8 dodań i 2 usunięć
  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: