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 ==