[[PageOutline(2-4)]]
= !TracDev/ApiChanges/0.11 =

'''Note: Development of Trac [milestone:0.11] has started with r3804 and the trunk now uses ''[http://genshi.edgewall.org/ Genshi]'' instead of ClearSilver, for its template engine.
Nevertheless, you should have in mind that the information in this page corresponds to a ''work in progress''.'''

== Migrating away from Clearsilver ==

ClearSilver has proven a bit uncomfortable to work with, and search for better alternatives were done a few months ago. The [http://kid-templating.org/ Kid] templating language was unanimously found appealing, to the point cmlenz did a porting of Trac to Kid, during the DrProject fork. This in turn was found painful, and prompted Christopher to start his own, enhanced, version of Kid currently maturing as [http://genshi.edgewall.org/ Genshi].

The migration from ClearSilver to Genshi was done on trunk in r3832.

You can start porting your plugins [TracDev/PortingFromClearSilverToGenshi from Clearsilver to Genshi].

== Date and Time Manipulations ==

Since r3935, Trac uses `datetime` objects internally, instead of timestamps.
More precisely, the database layer still uses `int` timestamps, but manipulation of time values is now done on `datetime` objects as soon as possible, see e.g. the [source:trunk/trac/Timeline.py Timeline] module.

Those `datetime` values are directly added by the controllers to the data model, and it's the responsibility of the ''templates'' to pick up the appropriate time representation, using one of the built-in date formatting utilities: `format_date`, `format_datetime`, `format_datetime`, `http_date`, `pretty_timedelta` (see [source:trunk/trac/chrome.py chrome.py]), or even the `$dateinfo()` macro. 

Those utilities automatically take into account the ''timezone'' information set by the user, so that the dates are presented in a meaningful way to him.