Changes between Version 62 and Version 63 of GitPlugin


Ignore:
Timestamp:
Oct 17, 2010, 8:24:57 PM (4 years ago)
Author:
hvr
Comment:

Major cleanup of wiki page

Legend:

Unmodified
Added
Removed
Modified
  • GitPlugin

    v62 v63  
    2020 - ...
    2121
     22=== Example Sites ===
     23
     24 - [http://nanosleep.org/proj/trac-git-plugin/browser nanosleep.org's GitPlugin branch] (using trac 0.10)
     25 - ''TODO: find public sites which use GitPlugin''
     26
    2227=== Requirements ===
    2328
     
    2732|| 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+ ||
    2833
    29 == Example Sites ==
    30 
    31  - [http://nanosleep.org/proj/trac-git-plugin/browser nanosleep.org's GitPlugin branch] (using trac 0.10)
    32 
    33 === Sites that were previously using GitPlugin ===
    34 
    35  - The GIT repositories at [https://hosted.fedoraproject.org/ Fedora Hosted]
    36  - [http://parted.alioth.debian.org/cgi-bin/trac.cgi/browser GNU Parted]
    37  - [https://reductivelabs.com/trac/puppet/browser ReductiveLabs Puppet]
    38  - [http://labs.ohloh.net/ Ohloh Labs]
    39  - [http://www.realassignmentwriting.com assignment help]
    40  - [http://www.realessaywriting.com essay help]
    41  - [http://www.uk2.net/web-hosting/ Hosting]
    42 
    4334== Bugs/Feature Requests ==
    4435
     
    6556(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].)
    6657
    67 == Install ==
     58== Installation ==
    6859
    6960See also generic instructions at trac:TracPlugins
     
    125116use_committer_time = false
    126117
    127 }}}
    128 
    129 '''/!\ NOTES''':
    130  - 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.
    131  - Wrong permissions may also be the cause of the error `!GitError: GIT control files not found, maybe wrong directory?`
    132  - 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.
    133 
    134 If installed globally, don't forget to enable the plugin:
    135 {{{
    136 [components]
    137 # for plugin version 0.10
    138 gitplugin.* = enabled
    139 
    140 # for plugin version 0.11.0.1+
    141 tracext.git.* = enabled
    142118}}}
    143119
     
    183159e.g. :
    184160{{{
    185 ...
    186 ...
    187 
    188161[trac]
    189162repository_dir = /path/to/git/repos.git/
    190 ...
    191163repository_sync_per_request =
    192 
    193 ...
    194164...
    195165
     
    199169tracopt.ticket.commit_updater.committicketupdater = enabled
    200170...
    201 ...
    202171}}}
    203172
    204173Also 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.
    205174
    206 
    207 == Help ==
    208 
    209 09/06/2010
    210 I was able to get this running with ubuntu karmic, trac 0.12rc and git version 1.7.1 (served with a gitosis install)
    211 after encountering the issue mentioned in [http://trac-hacks.org/ticket/5480 bug #5480]
    212 ("!GitError: GIT control files not found, maybe wrong directory?") with:
    213 {{{
    214   chmod o+rx /home/git/repositories/blah-blah.git
    215 }}}
    216 
    217 
    218 12/13/2009
    219 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
    220 
    221 15/04/2010
    222 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.'''
    223 
    224 13/07/2010
    225 I've managed to get it to work (at least, for it not to complain about the plugin being missing) by adding:
    226 
    227 file = /etc/trac/trac.ini
    228 
    229 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.
     175== Troubleshooting ==
     176
     177'''/!\ NOTES ''':
     178
     179 - 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.
     180
     181 - 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.
     182
     183 - 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.
     184
     185 - If installed globally, don't forget to enable the plugin:
     186{{{
     187[components]
     188# for plugin version 0.10
     189gitplugin.* = enabled
     190
     191# for plugin version 0.11.0.1+
     192tracext.git.* = enabled
     193}}}
    230194
    231195== Recent Changes ==