Trac: Difference between revisions
(→Developers: change sentence formation) |
(→Developers: add python info for mac) |
||
| Line 17: | Line 17: | ||
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. | 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'' [http://wiki.python.org/moin/MacPython/PythonDistributionsForMac]. 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 [http://trac.edgewall.org/wiki/0.13/TracInstall#MandatoryDependencies]. | |||
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 [http://docs.uabgrid.uab.edu/wiki/Python see here]. | |||
==== XAMPP ==== | |||
# [http://docs.uabgrid.uab.edu/wiki/XAMPP Install and configure XAMPP for Mac] | |||
# | |||
# Edit ''/Applications/XAMPP/etc/httpd.conf'' with the following <pre><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 | |||
</pre> | |||
== References == | == References == | ||
Revision as of 18:01, 3 December 2010
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,
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
- Install and configure XAMPP for Mac
- 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