Changes between Version 20 and Version 21 of TracDev/Proposals/Jinja

Timestamp:

Mar 17, 2016, 5:57:52 PM (8 years ago)

Author:

Christian Boos

Comment:

added #Status info, + links to CI pages

TracDev/Proposals/Jinja

@@ -6 +6 @@
 So one solution would be to switch once again, to a template engine that would combine the advantages of Genshi (pure Python, nice templates, flexible) and ClearSilver (speed!). Such a beast seems to exist now: **[http://jinja.pocoo.org/2/documentation/ Jinja2]**.
 
-There's an experimental branch which supports this proposal: [source:cboos.git@jinja2] (mirror available in [https://github.com/cboos/trac.git github]).
-
-Several points remain to be clarified: 
- * what will be the upgrade path for plugins that came to rely on `ITemplateStreamFilter`s?
-   - 127/898 plugins (14.1%) on trac-hacks.org use `filter_stream()`
-   - -> [PortingFromGenshiToJinja#ReplacingITemplateStreamFilter replacing ITemplateStreamFilter]
- * how to handle themeing? -> see HtmlTemplates#Jinjaarchitecture
- * should we rewrite tag builders or use lightweight string templates? -> [PortingFromGenshiToJinja#tag tag] `Fragment`/`Element` builder has been reimplemented
+There's an experimental branch which supports this proposal: [source:cboos.git@jinja2] \\
+(mirror available in [https://github.com/cboos/trac.git github] - 
+[[Image(https://travis-ci.org/cboos/trac.svg?branch=jinja2,link=https://travis-ci.org/cboos/trac,valign=bottom)]] on Travis, 
+[[Image(https://ci.appveyor.com/api/projects/status/kqgv4awct01hsl7t/branch/jinja2,link=https://ci.appveyor.com/project/cboos/trac/branch/jinja2,valign=bottom)]] on AppVeyor)
+
+[=#Status Status] of the branch (2016-03-17):
+ - ported **63%** of the Genshi templates, 2 unit-tests failure (with mysql and psql), 8 functional tests failures
+ - clarify upgrade path for plugins that came to rely on `ITemplateStreamFilter`s?
+   (127/898 plugins (14.1%) on trac-hacks.org use `filter_stream()`)
+   DONE -> see [PortingFromGenshiToJinja#ReplacingITemplateStreamFilter replacing ITemplateStreamFilter]
+ * clarify how to handle themeing? DONE -> see HtmlTemplates#Jinjaarchitecture
+ * rewrite tag builders ~~or use lightweight string templates~~? DONE -> [PortingFromGenshiToJinja#tag tag] `Fragment`/`Element` builder API has been reimplemented
+ - accesskey support TODO
+ - hack `ITemplateStreamFilter` support for Jinja2 templates TODO
+ - site.html replacement (e.g. try to reproduce t.e.o customizations) TODO
  * others?
 
@@ -19 +26 @@
 [gmessage:trac-users:PYqQ4UDRnl8/wg8lQzrGDAAJ Genshi question] on Trac-Users.
 
+The topic is now (Feb / March 2016) again discussed on [gdiscussion:trac-dev:KqWPQWuZ63k  trac-dev].
 
 
@@ -25 +33 @@
 Nothing like a few numbers to make a point ;-)
 
-These are the timings for rendering !r3871, with the diff options set to side-by-side, in place modifications, served by tracd on my development laptop. This generates a page weighing 11.5MB (Genshi) to 10.3MB (Jinja2) in size.
+These are the timings for rendering !r3871 (//don't try this one here, please//), with the diff options set to side-by-side, in place modifications, served by tracd on my development laptop. This generates a page weighing from 11.5MB (Genshi) to 10.3MB (Jinja2) in size.
 
 ||       ||||||||= Genshi                             ||||||||||||||||||||||||= Jinja2                                                                                     ||
@@ -66 +74 @@
 == Genshi to Jinja2 Migration
 
-Some systematic comparison of the Genshi and Jinja2 template syntax can be seen in PortingFromGenshiToJinja#Changesinthetemplatesyntax (modeled after the old PortingFromClearSilverToGenshi page). 
+Some systematic comparison of the Genshi and Jinja2 template syntax can be seen in PortingFromGenshiToJinja#Changesinthetemplatesyntax (that page was modeled after the old PortingFromClearSilverToGenshi page). 
 
 See also PortingFromGenshiToJinja/Example for a full example presented side-by-side.