Mercurial > p > roundup > code
comparison 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 |
comparison
equal
deleted
inserted
replaced
| 6751:2f7b653b7d6f | 6752:d640e9a5d6d7 |
|---|---|
| 2721 | 2721 |
| 2722 | 2722 |
| 2723 Templating engines | 2723 Templating engines |
| 2724 ~~~~~~~~~~~~~~~~~~ | 2724 ~~~~~~~~~~~~~~~~~~ |
| 2725 | 2725 |
| 2726 Since version 1.4.20 Roundup supports two templating engines: the original | 2726 Since version 1.4.20 Roundup supports two templating engines: |
| 2727 `Template Attribute Language`_ (TAL) engine from Zope and the standalone | 2727 |
| 2728 Chameleon templating engine. Chameleon is intended as a replacement for the | 2728 * the original `Template Attribute Language`_ (TAL) engine from Zope |
| 2729 original TAL engine, and supports the same syntax, | 2729 * the standalone Chameleon templating engine. Chameleon is intended |
| 2730 but they are not 100% compatible. The major (and most likely the only) | 2730 as a replacement for the original TAL engine, and supports the |
| 2731 incompatibility is the default expression type being | 2731 same syntax, but they are not 100% compatible. The major (and most |
| 2732 ``python:`` instead of ``path:``. See also "Incompatibilities and | 2732 likely the only) incompatibility is the default expression type being |
| 2733 differences" section of `Chameleon documentation`__. | 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 | |
| 2734 | 2745 |
| 2735 **NOTE1**: For historical reasons, examples given below assumes path | 2746 **NOTE1**: For historical reasons, examples given below assumes path |
| 2736 expression as default expression type. With Chameleon you have to manually | 2747 expression as default expression type. With Chameleon you have to manually |
| 2737 resolve the path expressions. A Chameleon-based, z3c.pt, that is fully | 2748 resolve the path expressions. A Chameleon-based, z3c.pt, that is fully |
| 2738 compatible with the old TAL implementation, is planned to be included in a | 2749 compatible with the old TAL implementation, is planned to be included in a |