Mercurial > p > roundup > code
diff doc/customizing.txt @ 6752:d640e9a5d6d7
Reformat templating section. Document jinja2.
Break TAL and Chameleon out into bulleted list from paragraph.
Add doc on jinja2 templating support and jinja2 template.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Mon, 04 Jul 2022 22:21:05 -0400 |
| parents | c68739264869 |
| children | e7b4ad2c57ac |
line wrap: on
line diff
--- a/doc/customizing.txt Mon Jul 04 19:53:39 2022 -0400 +++ b/doc/customizing.txt Mon Jul 04 22:21:05 2022 -0400 @@ -2723,14 +2723,25 @@ Templating engines ~~~~~~~~~~~~~~~~~~ -Since version 1.4.20 Roundup supports two templating engines: the original -`Template Attribute Language`_ (TAL) engine from Zope and the standalone -Chameleon templating engine. Chameleon is intended as a replacement for the -original TAL engine, and supports the same syntax, -but they are not 100% compatible. The major (and most likely the only) -incompatibility is the default expression type being -``python:`` instead of ``path:``. See also "Incompatibilities and -differences" section of `Chameleon documentation`__. +Since version 1.4.20 Roundup supports two templating engines: + + * the original `Template Attribute Language`_ (TAL) engine from Zope + * the standalone Chameleon templating engine. Chameleon is intended + as a replacement for the original TAL engine, and supports the + same syntax, but they are not 100% compatible. The major (and most + likely the only) incompatibility is the default expression type being + ``python:`` instead of ``path:``. See also "Incompatibilities and + differences" section of `Chameleon documentation`__. + +Version 1.5.0 added experimental support for the `jinja2`_ templating +language. You must install the `jinja2`_ module in order to use it. The +``jinja2`` template supplied with Roundup has the templates rewritten +to use ``jinja2`` rather than TAL. A number of trackers are running +using ``jinja2`` templating so it is considered less experimental than +Chameleon templating. + +.. _jinja2: https://palletsprojects.com/p/jinja/ + **NOTE1**: For historical reasons, examples given below assumes path expression as default expression type. With Chameleon you have to manually
