Trac

From Cheaha
Revision as of 18:01, 3 December 2010 by Ppreddy@uab.edu (talk | contribs) (→‎Developers: add python info for mac)
Jump to navigation Jump to search


Attention: Research Computing Documentation has Moved
https://docs.rc.uab.edu/


Please use the new documentation url https://docs.rc.uab.edu/ for all Research Computing documentation needs.


As a result of this move, we have deprecated use of this wiki for documentation. We are providing read-only access to the content to facilitate migration of bookmarks and to serve as an historical record. All content updates should be made at the new documentation site. The original wiki will not receive further updates.

Thank you,

The Research Computing Team

Introduction

Trac is an open source, web-based project management and bug-tracking tool (source:Wikipedia). Trac is built on python and provides a web interface to version control systems such as Subversion, Git, Mercurial etc. With its wiki markup capability, Trac serves as a great annotation tool for a project's source code.

End Users

For end users interested in using Trac as a wiki, ticket/bug reporting tool send an email to...

Coming soon, a self servicing web interface for provisioning a trac instance(TBD, a landing page...)

Developers

For developers, interested in customizing Trac (theme, plugins etc), setting up a development environment in one's own space without much fuss and moving parts, is of primary concern. This brings down to two essential components for developing for Trac,

  1. Python
  2. XAMPP (Apache, MySQL, PHP, Perl) stack.

NOTE: Though there may be any number of ways to set up an AMP stack, recommended here is one easy way which has cross-platform capability ie., XAMPP developed by Apache Friends.

Mac OS X

Python

Mac OS X comes with a pre-installation of Python, usually one or two years old [1]. Mac OS 10.6 (Snow Leopard) has 2.6.1 version of Python. This is adequate for developing Trac on Mac. Trac officially supports any Python version >=2.5 and <3.0 [2].

To have a complete development environment in your $HOME, python path must be configured properly. Before proceeding further, configure your PYTHONPATH to install python eggs in your $HOME instead of the system python path ie., /System/Library/Frameworks/Python.Framework or /Library/Frameworks/Python.FrameworkFor more details on Python for Macintosh see here.

XAMPP

  1. Install and configure XAMPP for Mac
  2. Edit /Applications/XAMPP/etc/httpd.conf with the following
    <Location /trac>

SetEnv TRAC_ENV_PARENT_DIR /Users/pnm/project-tmd/sites SetEnv PYTHONPATH /Users/pnm/Library/Python/2.6/site-packages SetEnv PYTHON_EGG_CACHE /Users/pnm/Library/Python/2.6/site-packages </Location> ScriptAlias /trac /Users/pnm/Sites/trac.cgi

References