= Trac on Windows with Python 2.5 =

''Warning: the following imply that you'll use [milestone:0.11 0.11dev] a.k.a '''trunk'''. It ''worksforme'', but YMMV as one can say in this situation ;)''

TracOnWindows/Rewrite focuses on installing 0.10 with Python 2.4, as this is currently the version for which all the required dependencies for [milestone:0.10] are easily available.

Using [milestone:0.10] with Python 2.5 should theoretically work if you manage to build ClearSilver for that version. This shouldn't be a big deal on Unix systems (mh, is that even true?) but it is likely to be problematic on Windows.

Fortunately, there's another option. For [milestone:0.10], we plan to switch to another templating engine, namely [http://genshi.edgewall.org/ Genshi], from fellow Trac developer Christopher Lenz.

The migration has actually already started, and should be usable by adventurous users (and that must be the case if you're using Python 2.5, right?).

If furthermore you don't need to interface with Subversion, then all you need besides Python 2.5 are a few Python packages.
As some packages require the latest development version of the software, you'll nevertheless need a `svn` client to checkout the software from their repositories.

== Installing Python 2.5 on Windows ==

Simply [http://www.python.org/download/releases/2.5/#download-the-release download] and install the appropriate .msi for your Python platform:
 - [http://www.python.org/ftp/python/2.5/python-2.5.msi Python-2.5.msi]
 - [http://www.python.org/ftp/python/2.5/python-2.5.amd64.msi Python-2.5.amd64.msi]
 - [http://www.python.org/ftp/python/2.5/python-2.5.ia64.msi Python-2.5.ia64.msi]

== Installing Genshi ==

[http://genshi.edgewall.org/wiki/Download#Zippackage Download] the zip package:
 - [http://ftp.edgewall.com/pub/genshi/Genshi-0.3.zip Genshi-0.3.zip]

Unzip, go in the folder, then run `python setup.py install`.

== Installing Trac ==

You simply need the latest trunk (0.11dev):
{{{
> cd C:\src
> svn checkout http://svn.edgewall.com/repos/trac/trunk
> cd trunk
> python setup.py install
}}}

Then, have a look at how to setup the TracEnvironment, use the TracStandalone web front-end and you're set.

== Installing the WebAdmin plugin (optional) ==

Install the following egg: [attachment:TracWebAdmin-0.1.2_genshidev_r3760-py2.5.egg]
(see TracPlugins for details if this is your first time plugin installation).

You can also grab it directly from the repository, and install it the same way you did for Trac:
{{{
> cd C:\src
> svn checkout http://svn.edgewall.com/repos/trac/sandbox/webadmin-genshi webadmin-genshi
> cd webadmin-genshi
> python setup.py install
}}}
Note if you catch an error:"ImportError: No module named setuptools" please download http://peak.telecommunity.com/dist/ez_setup.py and install the setuptools.

If for some reason the above step fails, either because there's no package for the Windows platform you're using or the setuptools don't manage to read information from your svn working copy (if you used Subversion 1.4 for doing the checkout), you'll probably need to install first a recent `setuptools` package, itself available from `http://svn.python.org/projects/sandbox/trunk/setuptools`. Version 0.7a1 (!r51948) from the repository worked for me. 


== Caveats ==

Of course, this is ''bleeding edge'' software, so you'll probably discover a few bugs when using Trac in this configuration. You will be more than welcomed to report these bugs, as we're currently actively developing [milestone:0.11].

Known issues:
 - ~~The report module is still not converted~~
 - ~~The ''group by'' feature of ''Custom queries'' doesn't sort the groups~~

If you're interested to help out, or if you have your own Clearsilver templates to migrate, you'll probably want to have a look at [wiki:TracDev/ApiChanges/0.11#MigratingawayfromClearsilver].

Feedback is also welcomed for the: 
 - source:sandbox/datetime branch
 - source:sandbox/jquery branch
 - source:sandbox/webadmin-genshi variant of the WebAdmin plugin

----
See also: TracOnWindows/Rewrite