= Release Notes for Trac [milestone:0.11] ''Genshi'' Release = '''Preliminary Note:''' - Trac 0.11 is still in heavy development and undergoing a lot of changes. == Highlights == * New template engine for generating content ([http://genshi.edgewall.org Genshi]) * New default syntax highlighter ([http://pygments.pocoo.org Pygments]) * Improved user preferences subsystem, among which the possibility for an user to select his time zone and disable access keys * The WebAdmin plugin is now an integral part of Trac * Blame support in the repository browser == Detailed User Visible Changes == === Time zone support === Each user can select which time zone they want timestamps to be presented in. If [http://pytz.sf.net pytz] is installed a complete list of time zones will be available, otherwise Trac will fall back on a shorter list from an internal time zone implementation. === [SetupTools Setuptools] is now used for the packaging === This means you'll be able to just do {{{ easy_install Trac }}} once we've made the release. It also means that a number of things had to be changed to make this work correctly. In particular, Trac no longer implicitly assumes nor installs global data in the `$prefix/share/trac`. Instead, you'll have to modify the configuration of your project environments to explicitly “inherit” a global configuration in [TracIni trac.ini], for example: {{{ [inherit] file = /etc/trac/trac.ini }}} This will load the configuration from the `/etc/trac/trac.ini` file, while of course allowing to override any global settings in the environment's configuration. In that global configuration, you can specify shared directories for templates and plugins, e.g.: {{{ [inherit] plugins_dir = /etc/trac/plugins/ templates_dir = /etc/trac/templates/ }}} '''Note''': ''naming of these options may still change until the final 0.11 release'' === Improved Syntax Highlighting === Trac can now use the ''[http://pygments.pocoo.org Pygments]'' syntax highlighter out-of-the-box. This is a much nicer syntax highlighter than the one previously supported (SilverCity, Enscript and PHP). === Lots of minor improvements === ... === Caveats === - The `[trac] base_url` setting is now mandatory for generating correct URLs outside the context of a user request. - The `[trac] templates_dir` setting is considered harmful... You probably need to remove that setting when you browse Trac and get the following plain text error: {{{ TemplateNotFound: Template "error.html" not found }}} === Wiki Macros === The change in templating engines necessitated a change in wiki macros. The !HelloWorld and Timestamp macros which are distributed with trac will not work as released. For examples of new style macros, see some of the macros which have already been ported at MacroBazaar or ports of !HelloWorld and Timestamp attached to #5274. == Developer-visible changes == === Genshi template engine === Trac now uses the [http://genshi.edgewall.org Genshi] template engine instead of ClearSilver. Plugins using the latter will still be supported in Trac 0.11, but probably not longer. === `datetime` everywhere === Trac used to handle time informations as `int` timestamps. Now we're using `datetime` objects. === Internal API changes === A detailed view of the API changes since 0.10.x can be found in ["TracDev/ApiChanges/0.11"]. == Acknowledgements == Many thanks to the growing number of people who have, and continue to, support the project. Also our thanks to all people providing feedback and bug reports that helps us making Trac better, easier to use and more effective. Without your invaluable help, Trac would not evolve. Thank you all. Finally, we offer hope that Trac will prove itself useful to like-minded programmers around the world, and that this release will prove an improvement over the last version. Please let us know. :-) /The Trac Team http://trac.edgewall.org/