Skip to content

Commit 7425c81

Browse files
committed
Reformat templating section. Document jinja2.
Break TAL and Chameleon out into bulleted list from paragraph. Add doc on jinja2 templating support and jinja2 template.
1 parent b0bb974 commit 7425c81

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

doc/customizing.txt

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2723,14 +2723,25 @@ How the templates work
27232723
Templating engines
27242724
~~~~~~~~~~~~~~~~~~
27252725

2726-
Since version 1.4.20 Roundup supports two templating engines: the original
2727-
`Template Attribute Language`_ (TAL) engine from Zope and the standalone
2728-
Chameleon templating engine. Chameleon is intended as a replacement for the
2729-
original TAL engine, and supports the same syntax,
2730-
but they are not 100% compatible. The major (and most likely the only)
2731-
incompatibility is the default expression type being
2732-
``python:`` instead of ``path:``. See also "Incompatibilities and
2733-
differences" section of `Chameleon documentation`__.
2726+
Since version 1.4.20 Roundup supports two templating engines:
2727+
2728+
* the original `Template Attribute Language`_ (TAL) engine from Zope
2729+
* the standalone Chameleon templating engine. Chameleon is intended
2730+
as a replacement for the original TAL engine, and supports the
2731+
same syntax, but they are not 100% compatible. The major (and most
2732+
likely the only) incompatibility is the default expression type being
2733+
``python:`` instead of ``path:``. See also "Incompatibilities and
2734+
differences" section of `Chameleon documentation`__.
2735+
2736+
Version 1.5.0 added experimental support for the `jinja2`_ templating
2737+
language. You must install the `jinja2`_ module in order to use it. The
2738+
``jinja2`` template supplied with Roundup has the templates rewritten
2739+
to use ``jinja2`` rather than TAL. A number of trackers are running
2740+
using ``jinja2`` templating so it is considered less experimental than
2741+
Chameleon templating.
2742+
2743+
.. _jinja2: https://palletsprojects.com/p/jinja/
2744+
27342745

27352746
**NOTE1**: For historical reasons, examples given below assumes path
27362747
expression as default expression type. With Chameleon you have to manually

0 commit comments

Comments
 (0)