[[PageOutline(2-5,Contents,pullout)]]

= Display Git location of source code

== Description

This plugin adds the Git location to the contextual navigation under the Browse Source navigation item:

[[Image(screenshot.png, border=2)]]

Even though with Git this info is static, ie it doesn't change depending on which folder is browsed in Trac, it still comes in handy for making checkouts and such.

== Source

You can browse the source from [http://github.com/witsch/TracGitLocation/ github] using Git, or check it out via:
{{{#!sh
$ git clone git://github.com/witsch/TracGitLocation.git
}}}

There is also a version on [pypi:TracGitLocation PyPi].

== Installation

Follow the normal [TracPlugins egg installation procedures].

Enable the plugin in the `[components]` section of your `trac.ini` file:
{{{#!ini
[components]
gitlocation.* = enabled
}}}

Finally, add a section to your project's `trac.ini` file with the Git location:
{{{#!ini
[git]
repository_url = git@foo.com:foobar
}}}

== Authors / Contributors

Git Location is a shameless rip-off of Erik Rose' [SubversionLocationPlugin Subversion Location plugin] and therefore also based on jhammel's SvnUrlsPlugin. Thanks, Erik & jhammel!