XP-Dev.com

XP-Dev.com Documentation - Trac

Instead of using XP-Dev.com’s own bug tracker, you can use Trac to host your project, tickets and wiki pages.

Create a Trac Project

  • Head to your Projects tab
  • Enter a name, an abbreviated name and ensure that Trac is selected as the issue tracker type
    • The abbreviated name that you have chosen will be used in the trac URL. For e.g. if you picked the abbreviated name mytracproject, your Trac project will be installed at http(s)://trac.xp-dev.com/mytracproject
  • Click on Create Project

  • Trac projects can take a few minutes to be created and configured. The warning (shown below) will disappear after a few minutes and your Trac project will be fully installed.

  • Do remember to login to your new Trac project. You should see similar tabs as the screen shot below:

Source Control Repositories with Trac

Just configure a source control repository like how you would do for any XP-Dev.com project under the Source Control tab.

Full instructions on configuring a source control repository can be found here

Trac Permissions

Adding and removing users from your Trac project is done using the usual way for any XP-Dev.com project.

Full instructions on how to add/remove users can be found here

Smart Commit Messages for Trac

Once you have configured a source control repository on your project, you will be able to use smart commit messages to reference your commits with Trac tickets, and even close/fix them.

The smart commit messages is a standard feature with Trac that has been enabled on all Trac projects hosted on XP-Dev.com.

The following text was taken directly from the comments on trac-post-commit-hook

It searches commit messages for text in the form of:
command #1
command #1, #2
command #1 & #2
command #1 and #2

Instead of the short-hand syntax “#1”, “ticket:1” can be used as well, e.g.:
command ticket:1
command ticket:1, ticket:2
command ticket:1 & ticket:2
command ticket:1 and ticket:2

In addition, the ‘:’ character can be omitted and issue or bug can be used
instead of ticket.

You can have more then one command in a message. The following commands
are supported. There is more then one spelling for each command, to make
this as user-friendly as possible.

close, closed, closes, fix, fixed, fixes
The specified issue numbers are closed with the contents of this
commit message being added to it.
references, refs, addresses, re, see
The specified issue numbers are left in their current status, but
the contents of this commit message are added to their notes.

A fairly complicated example of what you can do is with a commit message
of:

Changed blah and foo to do this or that. Fixes #10 and #12, and refs #12.

This will close #10 and #12, and add a note to #12.

Trac Plugins

The following plugins have been installed and enabled automatically on all XP-Dev.com Trac Projects: