Re: gitweb install

Jakub Narebski wrote:

lamikr wrote:

  

quoted

Hi

Following dummyuser test case (me :-) might be usefull for improving docs.
I have read the gitweb/README but in addition of that I find out that
there is really little documentation about installing gitweb
except the Makefile & git-instaweb.sh itself.

I would like to install gitweb to /var/run/html/gitweb directory and
after reading the git/INSTALL & gitweb/README
I came to conclusion that something like following could work

1) build git by changing some of the default gitweb configs as a user
    make prefix=/usr all doc GITWEB_SITENAME='gitweb test' \
         GITWEB_PROJECTROOT=/var/www/html/gitweb 
2) install git as a root after build
    make prefix=/usr install install-doc
3) add following to apache config
    <VirtualHost www:80>
        ServerName my-web-page
        DocumentRoot /gitweb
        RewriteEngine on
        RewriteRule ^/(.*\.git/(?!/?(info|objects|refs)).*)?$ /cgi-bin/gitweb.cgi%{REQUEST_URI}  [L,PT]
        SetEnv    GITWEB_CONFIG    /etc/gitweb.conf
    </VirtualHost>
4) move git repository (kernel for example) to /var/www/html/gitweb
    

It should be enough to symlink it, given appropriate setup.
  

Are people usually using symlinks to their "real development"
repositories? Or is it more common to have personal working repository
for example in the own home directory and then the second "public copy"
for http pages? And then configure the personal repository to push the
changes somehow to public one?
That would seem to be more secure even it rises the gap between real and
published changes.

quoted

5) restart apache
6) open browser to http://my-web-page/gitweb

Obviously something failed, as after step 2, I do not have either the
/etc/gitweb.conf or gitweb scripts under directory /var/www/html/gitweb
    

First, "make install" does not install the gitweb, as the place where
it should be installed depends from configuration to configuration.
By the way, you may compile ony gitweb using "make gitweb/gitweb.cgi"
with appropriate params. So 2.1) step would be to manually copy
gitweb.cgi and gitweb.css at least, perhaps also git-logo.png and
git-favicon.png.
  

Ok, I did that.

Second, you have to set up gitweb.cgi as a CGI script, or as legacy
mod_perl script. I have for example in /var/www/cgi-bin symlink named
gitweb to directory with gitweb.cgi, gitweb.css etc. and in
/var/www/perl symplink to the same place.

The CGI configuration for Apache2 is (simplest case, I'd appreciate
better solutions):

 LoadModule cgi_module modules/mod_cgi.so
 ScriptAlias /cgi-bin/ "/var/www/cgi-bin/"
 <Directory "/var/www/cgi-bin">
    Options Indexes FollowSymlinks ExecCGI
    AllowOverride None
    Order allow,deny
    Allow from all
 </Directory>
  

Thanks, it seems that in Mandriva the preferred way it to put each of
these to own files under webapps.d directory.
So I created following /etc/httpd/conf/webapps.d/gitweb.conf by using
your script and cgi-script examples from httpd.conf as a help and got
things working.
   
# gitweb Apache configuration file
Alias /gitweb /var/www/gitweb
<Directory "/var/www/gitweb">
    AllowOverride All
    Options ExecCGI FollowSymLinks SymLinksifOwnerMatch
    Order allow,deny
    Allow from all
    RewriteEngine on
    RewriteRule ^/(.*\.git/(?!/?(info|objects|refs)).*)?$
/cgi-bin/gitweb.cgi%{REQUEST_URI}  [L,PT]
    SetEnv    GITWEB_CONFIG    /etc/gitweb.conf
</Directory>

Is there btw, any examples from the /etc/gitweb.conf file?