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

Roundup Issue Tracker: http://roundup-tracker.org/