Permalink
Browse files

tweaked docs

  • Loading branch information...
1 parent 256f57e commit 620da47e7fc36c52005dd8b125c4fa4619a74544 @fabpot committed Sep 23, 2011
Showing with 18 additions and 0 deletions.
  1. +18 −0 doc/templates.rst
View
@@ -1628,6 +1628,9 @@ is ignored. To avoid name conflicts, you can rename imported blocks:
{% block title %}{% endblock %}
{% block content %}{% endblock %}
+.. versionadded:: 1.3
+ The ``parent()`` support was added in Twig 1.3.
+
The ``parent()`` function automatically determines the correct inheritance
tree, so it can be used when overriding a block defined in an imported
template:
@@ -1648,6 +1651,21 @@ template:
In this example, ``parent()`` will correctly call the ``sidebar`` block from
the ``blocks.html`` template.
+.. tip::
+
+ In Twig 1.2, renaming allows you to simulate inheritance by calling the
+ "parent" block:
+
+ .. code-block:: jinja
+
+ {% extends "base.html" %}
+
+ {% use "blocks.html" with sidebar as parent_sidebar %}
+
+ {% block sidebar %}
+ {{ block('parent_sidebar') }}
+ {% endblock %}
+
.. note::
You can use as many ``use`` statements as you want in any given template.

0 comments on commit 620da47

Please sign in to comment.