== Welcome to the Hackable Trac! ==

=== Quick intro ===

# Run **relocate.cmd**
# Run **env-sqlite.cmd** and choose an environment name
# Run **serve.cmd**
# Hack away in the Trac repository :D

Available in the [[https://bitbucket.org/alexandrul/bin/downloads|Downloads]] area.

=== Provided packages ===

See the included **requirements.txt** file for the up-to-date list.

==== Mercurial repositories ====

* https://bitbucket.org/edgewall/trac/
* https://hg.edgewall.org/trac/mercurial-plugin/
* https://bitbucket.org/alexandrul/trac-tags-plugin/

Both plugins are activated during the creation of Trac environments using the provided scripts.

==== Other packages ====

* distribute==0.6.28
* docutils==0.9.1
* epydoc==3.0.1
* Genshi==0.6
* Jinja2==2.6
* logilab-astng==0.24.0
* logilab-common==0.58.1
* mercurial==2.2.3
* pep8==1.3.3
* psycopg2==2.4.5
* Pygments==1.5
* pylint==0.25.2
* pytz==2012d
* reportlab==2.5
* rst2pdf==0.92
* Sphinx==1.1.3

=== More info ===

First, it works on my PC :D

To be safe, please avoid paths and environments containing spaces.

==== env-sqlite.cmd ====
Creates SQLite-based environments.

==== env-pgsql.cmd ====
Creates PostgreSQL-based environments, provided that the //H-TRAC-PGSQL// environment variable is enabled (and adjusted) in the **tracvars.cmd** script.

The included **psycopg2** package was compiled against PostgreSQL 9.1.4

==== serve.cmd ====
Runs **tracd.exe**, serving the environments from the **_data** folder.

==== integrate.cmd ====
Re-installs Trac and the Mercurial plugin. Might be required after updating the repositories.

==== relocate.cmd ====
Adjusts the **python.exe** location for the scripts after moving the hackable Trac to another folder.

==== prompt.cmd ====
Opens a command prompt for easy access to pip, easy_install, trac-admin, etc.

==== tracvars.cmd ====
Various settings required by the other scripts.
