Go to file
2024-04-23 15:48:42 -07:00
.devcontainer update project files (#5457) 2024-04-23 09:28:57 -07:00
.github upload/download-artifact v4 2024-04-23 15:48:42 -07:00
artwork documentation style updates, added print css 2008-05-06 12:14:23 +02:00
docs drop support for Python 3.7 2024-04-23 12:22:59 -07:00
examples/basic rename default branch in files 2021-05-11 16:24:15 -07:00
requirements update dev dependencies 2024-04-23 12:23:07 -07:00
scripts Merge branch '3.1.x' 2023-06-01 10:50:38 -07:00
src/jinja2 drop support for Python 3.7 2024-04-23 12:22:59 -07:00
tests satisfy formatter, linter, and strict mypy 2024-04-23 09:29:26 -07:00
.editorconfig update project files (#5457) 2024-04-23 09:28:57 -07:00
.gitignore update project files (#5457) 2024-04-23 09:28:57 -07:00
.pre-commit-config.yaml update project files (#5457) 2024-04-23 09:28:57 -07:00
.readthedocs.yaml update project files (#5457) 2024-04-23 09:28:57 -07:00
CHANGES.rst drop support for Python 3.7 2024-04-23 12:22:59 -07:00
CONTRIBUTING.rst switch to flit build backend 2023-06-28 07:31:12 -07:00
LICENSE.txt update project files (#5457) 2024-04-23 09:28:57 -07:00
pyproject.toml drop support for Python 3.7 2024-04-23 12:22:59 -07:00
README.md update project files (#5457) 2024-04-23 09:28:57 -07:00
tox.ini drop support for Python 3.7 2024-04-23 12:22:59 -07:00

Jinja

Jinja is a fast, expressive, extensible templating engine. Special placeholders in the template allow writing code similar to Python syntax. Then the template is passed data to render the final document.

It includes:

  • Template inheritance and inclusion.
  • Define and import macros within templates.
  • HTML templates can use autoescaping to prevent XSS from untrusted user input.
  • A sandboxed environment can safely render untrusted templates.
  • AsyncIO support for generating templates and calling async functions.
  • I18N support with Babel.
  • Templates are compiled to optimized Python code just-in-time and cached, or can be compiled ahead-of-time.
  • Exceptions point to the correct line in templates to make debugging easier.
  • Extensible filters, tests, functions, and even syntax.

Jinja's philosophy is that while application logic belongs in Python if possible, it shouldn't make the template designer's job difficult by restricting functionality too much.

In A Nutshell

.. code-block:: jinja

{% extends "base.html" %}
{% block title %}Members{% endblock %}
{% block content %}
  <ul>
  {% for user in users %}
    <li><a href="{{ user.url }}">{{ user.username }}</a></li>
  {% endfor %}
  </ul>
{% endblock %}

Donate

The Pallets organization develops and supports Jinja and other popular packages. In order to grow the community of contributors and users, and allow the maintainers to devote more time to the projects, please donate today.