{% block title %}Example{% endblock %}

Language overview ================== - ``{{ ... }}`` for variables to print to the template output - ``{% ... %}`` for tags - ``{# ... #}`` for comments not included in the template output Variables --------- A variable can be defined in your template using the following: .. code-block:: html+django {{ variable }} Stencil will look up the variable inside the current variable context and evaluate it. When a variable contains a dot, it will try doing the following lookup: - Context lookup - Dictionary lookup - Array and string lookup (first, last, count, by index) - Key value coding lookup - Type introspection (via ``Mirror``) For example, if `people` was an array: .. code-block:: html+django There are {{ people.count }} people. {{ people.first }} is the first person, followed by {{ people.1 }}. You can also use the subscript operator for indirect evaluation. The expression between brackets will be evaluated first, before the actual lookup will happen. For example, if you have the following context: .. code-block:: swift [ "item": [ "name": "John" ], "key": "name" ] .. code-block:: html+django The result of {{ item[key] }} will be the same as {{ item.name }}. It will first evaluate the result of {{ key }}, and only then evaluate the lookup expression. Filters ~~~~~~~ Filters allow you to transform the values of variables. For example, they look like: .. code-block:: html+django {{ variable|uppercase }} See :ref:`all builtin filters `. Tags ---- Tags are a mechanism to execute a piece of code, allowing you to have control flow within your template. .. code-block:: html+django {% if variable %} {{ variable }} was found. {% endif %} A tag can also affect the context and define variables as follows: .. code-block:: html+django {% for item in items %} {{ item }} {% endfor %} Stencil includes of built-in tags which are listed below. You can also extend Stencil by providing your own tags. See :ref:`all builtin tags `. Comments -------- To comment out part of your template, you can use the following syntax: .. code-block:: html+django {# My comment is completely hidden #} .. _template-inheritance: Template inheritance -------------------- Template inheritance allows the common components surrounding individual pages to be shared across other templates. You can define blocks which can be overidden in any child template. Let's take a look at an example. Here is our base template (``base.html``): .. code-block:: html+django {% block title %}Example{% endblock %}

{% block content %}{% endblock %}

This example declares three blocks, ``title``, ``sidebar`` and ``content``. We can use the ``{% extends %}`` template tag to inherit from out base template and then use ``{% block %}`` to override any blocks from our base template. A child template might look like the following: .. code-block:: html+django {% extends "base.html" %} {% block title %}Notes{% endblock %} {% block content %} {% for note in notes %}

{% endfor %} {% endblock %} .. note:: You can use ``{{ block.super }}` inside a block to render the contents of the parent block inline. Since our child template doesn't declare a sidebar block. The original sidebar from our base template will be used. Depending on the content of ``notes`` our template might be rendered like the following: .. code-block:: html Notes

Pick up food

Do laundry

You can use as many levels of inheritance as needed. One common way of using inheritance is the following three-level approach: * Create a ``base.html`` template that holds the main look-and-feel of your site. * Create a ``base_SECTIONNAME.html`` template for each “section” of your site. For example, ``base_news.html``, ``base_news.html``. These templates all extend ``base.html`` and include section-specific styles/design. * Create individual templates for each type of page, such as a news article or blog entry. These templates extend the appropriate section template.

{{ note }}

Pick up food

Do laundry