The Basics¶

Tpll is a Template Engine inspired by the Django Template Language.

Variables¶

Variables are surrounded by {{ and }} like this:

My first name is {{ first_name }}. My last name is {{ last_name }}.

With the context of:

[("first_name", cStr "John"), ("last_name", cStr "Doe")]

This template renders to:

My first name is John. My last name is Doe.

Filters can be used in values or variables to transform its value.

For example:

{{ "foo"|upper }}

Will render to:

FOO

The same way for variables. With the context of:

[("x", "BAR")]

And the template:

foo {{ x|lower }}

Will render to:

foo bar

Tags are surrounded by {% and %} like this:

{% now %}

And can receive multiple arguments:

{% tag arg1 arg2 arg3 %}

This is the most common format to pass arguments to a tag, but some tags use other formats for usability. As an example, the for tag:

{% for arg1 in arg2 %}

Tags can also consume blocks containing texts, variables or even other tags, like the for tag:

<ul>
{% for arg1 in arg2 %}
    <li>Value: {{ arg 1 }}
{% endfor %}
</ul>

In this example, the for tag will iterate over all values in arg2, rendering everything until the endfor tag for each iteration.

With the context of:

[("arg2", cList [(cInt 1, cInt 2, cInt 5)])]

This template renders to:

<ul>
    <li>Value: 1
    <li>Value: 2
    <li>Value: 5
</ul>

You comment out a block using the {% comment %} ... {% endcomment %} tag like this:

this

{% comment %} will not be rendered {% endcomment %}

:)

Will render to:

this

:)