Edgewall Software

Changes between Version 37 and Version 38 of TracDev/PortingFromGenshiToJinja


Ignore:
Timestamp:
Jan 27, 2017, 11:43:44 PM (7 years ago)
Author:
Christian Boos
Comment:

update branch name, milestone:1.3.2 as integration target

Legend:

Unmodified
Added
Removed
Modified
  • TracDev/PortingFromGenshiToJinja

    v37 v38  
    22** Warning **
    33
    4 The following documentation corresponds to the [Proposals/Jinja Jinja] development proposal; it will be in Trac 1.3.x if all goes well \\
    5 (Git branch: [log:cboos.git@jinja2] (original) - [log:cboos.git@jinja2-trunk-r15341] (latest) - [https://github.com/cboos/trac.git github mirror]).
     4The following documentation corresponds to the [Proposals/Jinja Jinja] development proposal; it will be in Trac [milestone:1.3.2] if all goes well \\
     5(Git branch: [log:cboos.git@jinja2] (original) - [log:cboos.git@jinja2-trunk-r15379] (latest) - [https://github.com/cboos/trac.git github mirror]).
    66
    77Track the integration progress in #12639.
     
    1111= Porting Templates from Genshi to Jinja2
    1212
    13 The following documentation is primarily targeted at plugin developers who wish to adapt their Genshi templates to the Jinja2 template engine that will be used in Trac 1.4.
     13The following documentation is primarily targeted at plugin developers who wish to adapt their Genshi templates to the Jinja2 template engine that will be used in Trac [milestone:1.4].
    1414
    1515For migrating your own templates, a good way to start is to learn from examples.
     
    2020The last part of the document describes the Python code changes, focusing notably on how to replace the deprecated `ITemplateStreamFilter` interface.
    2121
    22 Note that Genshi will be supported concurrently with Jinja2 only for a short while, for the 1.3.x development period and for the 1.4-stable period. If for some reason you're stuck to having to support Genshi templates, you'll have to stick to Trac 1.2.x or 1.3.x. But you really should make the transition effort as Jinja2 templates are 5-10x faster than their Genshi equivalent, for only a 1/5th of the cost in memory usage.
     22Note that Genshi will be supported concurrently with Jinja2 only for a short while, for the 1.3.x development period and for the 1.4-stable period. If for some reason you're stuck to having to support Genshi templates, you'll have to stick to Trac 1.2.x or 1.3.1. But you really should make the transition effort as Jinja2 templates are 5-10x faster than their Genshi equivalent, for only a 1/5th of the cost in memory usage.
    2323
    2424