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

= Git Location Plugin

== Description

This plugin adds the Git Location to the contextual navigation under Browse Source. 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.

[[Image(screenshot.png)]]

== Source

You can browser 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:
{{{#!ini
[git]
repository_url = git@foo.com:foobar
}}}

== Credits

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!