Ticket #8088: templates_doc.diff

docs/templates.txt

@@ -877 +877 @@
 "including" other templates within a template.
 
 The template name can either be a variable or a hard-coded (quoted) string,
-in either single or double quotes.
+in either single or double quotes. **New in development version:**:
+Filters may be applied for both variable and hard-coded string.
 
 This example includes the contents of the template ``"foo/bar.html"``::
 
@@ -888 +889 @@
 
     {% include template_name %}
 
+**New in development version:**: This example includes the content of the
+template whose name consists of value of the variable, followed by ``.txt``
+in lowercase::
+
+    {% include template_name|lower|stringformat:"s.txt" %}
+
 An included template is rendered with the context of the template that's
 including it. This example produces the output ``"Hello, John"``:
 
@@ -900 +907 @@
 
         Hello, {{ person }}
 
+.. admonition:: Warning
+
+    Only a hard-coded (quoted) string without any filter as a template name
+    raises ``TemplateDoesNotExist`` exception in debug mode, if such template
+    could not be found. In case of variable, or expression
+    containing filters, Django template system fails silently.
+
 See also: ``{% ssi %}``.
 
 load
@@ -1258 +1272 @@
 
 Capitalizes the first character of the value.
 
+cat
+~~~
+
+**New in Django development version**
+
+Concatenates given string with argument.
+
+For example::
+    
+    {{ value|cat:".txt" }}
+
+if ``value`` is ``"note"``, the output will be ``note.txt``
+
 center
 ~~~~~~
 
@@ -1948 +1975 @@
     * Textile
     * Markdown
     * ReST (ReStructured Text)
+    * asciidoc
 
 See the `markup section`_ of the `add-ons documentation`_ for more
 information.