gitweb: add documentation to INSTALL regarding gitweb.js

This patch updates gitweb/INSTALL to mention gitweb.js, including
JavaScript minification support.

Signed-off-by: Mark Rada <marada@uwaterloo.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Mark Rada
2010-04-02 20:36:44 -04:00
committed by Junio C Hamano
parent 09b89d1a08
commit a8ab675f21

View File

@ -3,8 +3,9 @@ GIT web Interface (gitweb) Installation
First you have to generate gitweb.cgi from gitweb.perl using First you have to generate gitweb.cgi from gitweb.perl using
"make gitweb/gitweb.cgi", then copy appropriate files (gitweb.cgi, "make gitweb/gitweb.cgi", then copy appropriate files (gitweb.cgi,
gitweb.css, git-logo.png and git-favicon.png) to their destination. gitweb.js, gitweb.css, git-logo.png and git-favicon.png) to their
For example if git was (or is) installed with /usr prefix, you can do destination. For example if git was (or is) installed with /usr prefix,
you can do
$ make prefix=/usr gitweb/gitweb.cgi ;# as yourself $ make prefix=/usr gitweb/gitweb.cgi ;# as yourself
# cp gitweb/git* /var/www/cgi-bin/ ;# as root # cp gitweb/git* /var/www/cgi-bin/ ;# as root
@ -62,14 +63,15 @@ file for gitweb (in gitweb/README).
a suggestion). a suggestion).
- You can control where gitweb tries to find its main CSS style file, - You can control where gitweb tries to find its main CSS style file,
its favicon and logo with the GITWEB_CSS, GITWEB_FAVICON and GITWEB_LOGO its JavaScript file, its favicon and logo with the GITWEB_CSS, GITWEB_JS
build configuration variables. By default gitweb tries to find them GITWEB_FAVICON and GITWEB_LOGO build configuration variables. By default
in the same directory as gitweb.cgi script. gitweb tries to find them in the same directory as gitweb.cgi script.
- You can optionally generate a minified version of gitweb.css by defining - You can optionally generate minified versions of gitweb.js and gitweb.css
the CSSMIN build configuration variable. By default the non-minified by defining the JSMIN and CSSMIN build configuration variables. By default
version of gitweb.css will be used. NOTE: if you enable this option, the non-minified versions will be used. NOTE: if you enable this option,
substitute gitweb.min.css for all uses of gitweb.css in the help files. substitute gitweb.min.js and gitweb.min.css for all uses of gitweb.js and
gitweb.css in the help files.
Build example Build example
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
@ -79,13 +81,14 @@ Build example
we want to display are under /home/local/scm, you can do we want to display are under /home/local/scm, you can do
make GITWEB_PROJECTROOT="/home/local/scm" \ make GITWEB_PROJECTROOT="/home/local/scm" \
GITWEB_JS="/gitweb/gitweb.js" \
GITWEB_CSS="/gitweb/gitweb.css" \ GITWEB_CSS="/gitweb/gitweb.css" \
GITWEB_LOGO="/gitweb/git-logo.png" \ GITWEB_LOGO="/gitweb/git-logo.png" \
GITWEB_FAVICON="/gitweb/git-favicon.png" \ GITWEB_FAVICON="/gitweb/git-favicon.png" \
bindir=/usr/local/bin \ bindir=/usr/local/bin \
gitweb/gitweb.cgi gitweb/gitweb.cgi
cp -fv ~/git/gitweb/gitweb.{cgi,css} \ cp -fv ~/git/gitweb/gitweb.{cgi,js,css} \
~/git/gitweb/git-{favicon,logo}.png \ ~/git/gitweb/git-{favicon,logo}.png \
/var/www/cgi-bin/gitweb/ /var/www/cgi-bin/gitweb/