Skip to content

toutantic/github-trac

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This fork add support for multiple repository (Trac 0.12).
It will forward code browsing url to github only for git repositories

All your trac local git directory must be under the same root dir
The name of your trac git repository must match the name of your repository in github.

======================================================================================================

This trac plugin is designed to accept a GitHub Post-Receive url.

It also allows you to replace the builtin Trac browser with redirects to the GitHub source browser.

More information about the Post-Receive Hook can be found here:
http://github.com/guides/post-receive-hooks

To install this Trac Plugin:

    1. Clone the repository:
        git clone git://github.com/davglass/github-trac.git

    2. Install SimpleJSON:
        easy_install simplejson

    3. Install the Plugin:
        cd github
        sudo python setup.py install

    4. Configure Trac by editing your trac.ini
        
        [components]
        github.* = enabled

        [github]
        apitoken = YOUR GITHUB API TOKEN
        closestatus = closed (This is optional, defaults to closed
        username = your github user or organisation name
        
        browser = http://github.com/davglass/tree/master
    	#This is the path where all your git repo are don't forget the ending /
    	gitreposdir = /var/git/
        #Optional - perform a fetch on the local git repository
        autofetch = true
        
    5. Go to the Admin page for your project on GitHub. Then select the services tab.
        Under the: Post-Receive URLs
        Place a link to your Trac repository, in a format like this:
        
        http://yourdomian.com/trac/github/APITOKEN

        You can get your GitHub API token from your accounts page.
        This is for your security, only those that know the API Token will able to post to this url

    6. All done.


======================================================================================================

The commit hook is designed to close or mark tickets that are attached to a commit message.


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

======================================================================================================

The Code Browser

The code browser portion of the plugin is designed to replace the code browser built into Trac with a
redirect to the GitHub source browser.

In order for this to work properly, you still need to have Trac set to show a git repository. Turning this off
will not show source control links in other places (timeline). This git repository needs to be a synced clone of
your GitHub repository. Trac requires the GitPlugin in order to show a Git Repository: http://trac-hacks.org/wiki/GitPlugin


This plugin will attempt to intercept the /browser and /changeset url's and redirect you to the proper GitHub url.

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.5%
  • Shell 0.5%