diff options
author | IRIS YANG <irisykyang@google.com> | 2020-08-18 13:17:02 +0000 |
---|---|---|
committer | IRIS YANG <irisykyang@google.com> | 2020-08-18 13:31:16 +0000 |
commit | 3121357a0d62a6fe8c9fdcbfe5fd91f12b8f380d (patch) | |
tree | 2046b95d53a74b793dd54b7ea6e1b86724b93435 /README.rst | |
parent | 81aec74062b5c629b3408f7f3d18343ec0bbcab8 (diff) | |
download | jinja-3121357a0d62a6fe8c9fdcbfe5fd91f12b8f380d.tar.gz |
Revert "Revert "Import external/python/jinja into master""
This reverts commit 81aec74062b5c629b3408f7f3d18343ec0bbcab8.
Reason for revert: It seems Jinja folder is empty. Revert the revert to add files back.
Third-party review: ag/11821018
Change-Id: I4429a3b3448cdf2eb62ec388392a2a29fa3dbc21
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/README.rst b/README.rst new file mode 100644 index 00000000..060b19ef --- /dev/null +++ b/README.rst @@ -0,0 +1,66 @@ +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. + + +Installing +---------- + +Install and update using `pip`_: + +.. code-block:: text + + $ pip install -U Jinja2 + +.. _pip: https://pip.pypa.io/en/stable/quickstart/ + + +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 %} + + +Links +----- + +- Website: https://palletsprojects.com/p/jinja/ +- Documentation: https://jinja.palletsprojects.com/ +- Releases: https://pypi.org/project/Jinja2/ +- Code: https://github.com/pallets/jinja +- Issue tracker: https://github.com/pallets/jinja/issues +- Test status: https://dev.azure.com/pallets/jinja/_build +- Official chat: https://discord.gg/t6rrQZH |