Go to file
Tim Gates 91a404073a Fix simple typo: problemtic -> problematic (#1059)
Plus rephrase the comment for greater clarity.
2019-09-04 18:12:07 -04:00
.github Improve issue template 2017-01-09 17:37:18 +01:00
artwork documentation style updates, added print css 2008-05-06 12:14:23 +02:00
docs Merge branch '2.10.x' 2019-07-26 15:21:16 -07:00
examples change py2 print statements to py3 2015-03-22 14:25:15 +01:00
ext Merge pull request #990 from tbnorth/vim_syntax_tweak 2019-07-22 07:55:11 -07:00
jinja2 Fix simple typo: problemtic -> problematic (#1059) 2019-09-04 18:12:07 -04:00
scripts modernize docs config, use pallets-sphinx-themes 2019-07-26 11:41:08 -07:00
tests Merge branch '2.10.x' 2019-07-26 15:21:16 -07:00
.azure-pipelines.yml switch tests to azure pipelines 2019-07-20 12:44:26 -07:00
.gitignore Add ChainableUndefined allowing getattr & getitem (#997) 2019-05-08 10:47:33 -04:00
AUTHORS Add myself to AUTHORS 2018-06-27 22:02:45 +02:00
CHANGES.rst Merge branch '2.10.x' 2019-09-04 08:25:09 -07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2019-05-06 13:10:17 -04:00
LICENSE.rst standardize license 2019-07-17 08:01:46 -07:00
MANIFEST.in clean up MANIFEST.in 2017-11-08 10:53:47 -08:00
README.rst Update PyPI link to point to Jinja2 instead of 1 2019-08-08 17:14:03 -07:00
setup.cfg switch tests to azure pipelines 2019-07-20 12:44:26 -07:00
setup.py standardize license 2019-07-17 08:01:46 -07:00
tox.ini fix tox docs build 2019-07-26 15:17:58 -07:00

Jinja2
~~~~~~

Jinja2 is a template engine written in pure Python.  It provides a
`Django`_ inspired non-XML syntax but supports inline expressions and
an optional `sandboxed`_ environment.

Nutshell
--------

Here a small example of a Jinja template:

.. code-block:: jinja

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

Philosophy
----------

Application logic is for the controller, but don't make the template designer's
life difficult by restricting functionality too much.

For more information visit the new `Jinja2 webpage`_ and `documentation`_.

The `Jinja2 tip`_ is installable via ``pip`` with ``pip install
https://github.com/pallets/jinja/zipball/master``.

.. _sandboxed: https://en.wikipedia.org/wiki/Sandbox_(computer_security)
.. _Django: https://www.djangoproject.com/
.. _Jinja2 webpage: http://jinja.pocoo.org/
.. _documentation: http://jinja.pocoo.org/docs/
.. _Jinja2 tip: http://jinja.pocoo.org/docs/intro/#as-a-python-egg-via-easy-install

Builds
------

+---------------------+------------------------------------------------------------------------------+
| ``master``          | .. image:: https://travis-ci.org/pallets/jinja.svg?branch=master             |
|                     |     :target: https://travis-ci.org/pallets/jinja                             |
+---------------------+------------------------------------------------------------------------------+
| ``2.9-maintenance`` | .. image:: https://travis-ci.org/pallets/jinja.svg?branch=2.9-maintenance    |
|                     |     :target: https://travis-ci.org/pallets/jinja                             |
+---------------------+------------------------------------------------------------------------------+

Links
-----

* Website: http://jinja.pocoo.org/
* Documentation: http://jinja.pocoo.org/docs/
* License: `BSD <https://raw.githubusercontent.com/pallets/jinja/master/LICENSE>`_
* Releases: https://pypi.org/project/Jinja2/
* Code: https://github.com/pallets/jinja
* Issue tracker: https://github.com/pallets/jinja/issues
* Official chat: https://discord.gg/t6rrQZH