.. highlight:: html+jinja
Synopsis
--------
A Jinja template is simply a text file. Jinja can generate any text-based
format (HTML, XML, CSV, LaTeX, etc.). A Jinja template doesn't need to have a
specific extension: ``.html``, ``.xml``, or any other extension is just fine.
A template contains **variables** and/or **expressions**, which get replaced
with values when a template is *rendered*; and **tags**, which control the
logic of the template. The template syntax is heavily inspired by Django and
Python.
Below is a minimal template that illustrates a few basics using the default
Jinja configuration. We will cover the details later in this document::
My Webpage
My Webpage
{{ a_variable }}
{# a comment #}
The following example shows the default configuration settings. An application
developer can change the syntax configuration from ``{% foo %}`` to ``<% foo
%>``, or something similar.
There are a few kinds of delimiters. The default Jinja delimiters are
configured as follows:
* ``{% ... %}`` for :ref:`Statements `
* ``{{ ... }}`` for :ref:`Expressions` to print to the template output
* ``{# ... #}`` for :ref:`Comments` not included in the template output
* ``# ... ##`` for :ref:`Line Statements `