diff options
| author | mcgeeco <mcgeeco@tcd.ie> | 2014-10-14 13:48:45 +0100 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2014-10-16 10:54:35 -0400 |
| commit | b729ef0bda5009389da7e3a5498dc1f6233761d6 (patch) | |
| tree | c9715b0ca6718c6a9144b661d48fe850a21b644a /docs | |
| parent | 813954f15a2256c05cd29740f55aa882322727a1 (diff) | |
[1.7.x] Fixed #12008 -- Clarified relationship between template blocks and includes.
Thanks Daniele Procida for suggested wording.
Backport of 80b8d3bee0 from master
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/templates/builtins.txt | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 893a450f03..7671d59291 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -738,6 +738,11 @@ available to the included template:: This means that there is no shared state between included templates -- each include is a completely independent rendering process. + Blocks are evaluated *before* they are included. This means that a template + that includes blocks from another will contain blocks that have *already + been evaluated and rendered* - not blocks that can be overridden by, for + example, an extending template. + See also: :ttag:`{% ssi %}<ssi>`. .. templatetag:: load |