Changes between Version 62 and Version 63 of GitPlugin

Timestamp:

Oct 17, 2010, 6:24:57 PM (14 years ago)

Author:

Herbert Valerio Riedel

Comment:

Major cleanup of wiki page

GitPlugin

@@ -20 +20 @@
  - ...
 
+=== Example Sites ===
+
+ - [http://nanosleep.org/proj/trac-git-plugin/browser nanosleep.org's GitPlugin branch] (using trac 0.10)
+ - ''TODO: find public sites which use GitPlugin''
+
 === Requirements ===
 
@@ -27 +32 @@
 || GIT    || 1.4.4+      || 1.5.2+ (for plugin v0.11.0.1) [[BR]] 1.5.6+ (for plugin v0.11.0.2+) || 1.5.6+ ||
 
-== Example Sites ==
-
- - [http://nanosleep.org/proj/trac-git-plugin/browser nanosleep.org's GitPlugin branch] (using trac 0.10)
-
-=== Sites that were previously using GitPlugin ===
-
- - The GIT repositories at [https://hosted.fedoraproject.org/ Fedora Hosted]
- - [http://parted.alioth.debian.org/cgi-bin/trac.cgi/browser GNU Parted]
- - [https://reductivelabs.com/trac/puppet/browser ReductiveLabs Puppet]
- - [http://labs.ohloh.net/ Ohloh Labs] 
- - [http://www.realassignmentwriting.com assignment help]
- - [http://www.realessaywriting.com essay help]
- - [http://www.uk2.net/web-hosting/ Hosting]
-
 == Bugs/Feature Requests == 
 
@@ -65 +56 @@
 (An experimental branch of this plugin with a hacky caching feature and some bug fixes is available from [http://nanosleep.org/proj/trac-git-plugin/ here].)
 
-== Install ==
+== Installation ==
 
 See also generic instructions at trac:TracPlugins
@@ -125 +116 @@
 use_committer_time = false
 
-}}}
-
-'''/!\ NOTES''': 
- - the `Test.git` above needs to be the `.git` repository directory (i.e. the one containing the file `HEAD` and `config`), not the working tree directory that holds the `.git/` folder.
- - Wrong permissions may also be the cause of the error `!GitError: GIT control files not found, maybe wrong directory?`
- - If you are noticing a '''slow down in trac''' with a repository above 500 commits, try disabling the caching. It seems to bog things down as a repo grows.
-
-If installed globally, don't forget to enable the plugin:
-{{{
-[components]
-# for plugin version 0.10
-gitplugin.* = enabled
-
-# for plugin version 0.11.0.1+
-tracext.git.* = enabled 
 }}}
 
@@ -183 +159 @@
 e.g. :
 {{{
-...
-...
-
 [trac]
 repository_dir = /path/to/git/repos.git/
-...
 repository_sync_per_request =
-
-...
 ...
 
@@ -199 +169 @@
 tracopt.ticket.commit_updater.committicketupdater = enabled
 ...
-...
 }}}
 
 Also make sure that the user executing the trac-admin command has read access to your TRAC_ENV and write access to your trac.log as well as to your trac database.
 
-
-== Help ==
-
-09/06/2010
-I was able to get this running with ubuntu karmic, trac 0.12rc and git version 1.7.1 (served with a gitosis install)
-after encountering the issue mentioned in [http://trac-hacks.org/ticket/5480 bug #5480]
-("!GitError: GIT control files not found, maybe wrong directory?") with:
-{{{
-  chmod o+rx /home/git/repositories/blah-blah.git
-}}} 
-
-
-12/13/2009
-Anyone get this working in a shared hosting environment? I've tried with trac 0.11 and I get errors about it not finding the Git component (I did all the trac.ini stuff). If you have instructions please contact me, codecraig -at- gmail -dot- com ....thanks
-
-15/04/2010
-Apparently this does not work at all... At least not for me. trac 0.11. '''Please file a ticket with a decent problem report, instead of writing random notworkings on the wikipage.'''
-
-13/07/2010
-I've managed to get it to work (at least, for it not to complain about the plugin being missing) by adding:
-
-file = /etc/trac/trac.ini
-
-to the \[inherit\] section of the individual projects' trac.ini.   Or, of course, you could probably just configure the plugin for that particular project's trac.ini directly.
+== Troubleshooting ==
+
+'''/!\ NOTES ''': 
+
+ - the `Test.git` in the configuration section above needs to be the `.git` repository directory (i.e. the one containing the file `HEAD` and `config`), not the working tree directory that holds the `.git/` folder.
+
+ - Wrong permissions may also be the cause of the error `!GitError: GIT control files not found, maybe wrong directory?`. Make sure the `repository_dir` argument is accessible via `git` by the `tracd` process.
+
+ - If you are noticing a '''slow down in trac''' with a repository above 500 commits, try disabling the caching. It seems to bog things down as a repo grows.
+
+ - If installed globally, don't forget to enable the plugin:
+{{{
+[components]
+# for plugin version 0.10
+gitplugin.* = enabled
+
+# for plugin version 0.11.0.1+
+tracext.git.* = enabled 
+}}}
 
 == Recent Changes ==