Gitalist is also mirrored to github, and a number of people have active
forks with branches and/or new features in the master branch.
+BOOTSTRAPPING
+ As of 0.002001 Gitalist can now be bootstrapped to run out of its own
+ directory by installing its prerequisites locally with the help of
+ local::lib. So instead of installing the prerequisites to the system
+ path with CPAN they are installed under the Gitalist directory.
+
+ To do this clone Gitalist from the Shadowcat repository mentioned above
+ or grab a snapshot from broquaint's github repository:
+
+ http://github.com/broquaint/Gitalist/downloads
+
+ With the source acquired and unpacked run the following from within the
+ Gitalist directory:
+
+ perl script/bootstrap.pl
+
+ This will install the necessary modules for the build process which in
+ turn installs the prerequisites locally.
+
+ *NB* The relevant bootstrap scripts aren't available in the CPAN dist as
+ the bootstrap scripts should not be installed.
+
INITIAL CONFIGURATION
Gitalist is configured using Catalyst::Plugin::Configloader. The
supplied sample configuration is in Config::General format, however it
http://example.gitalist.com
+ FASTCGI
+ Running Gitalist in FastCGI mode requires a webserver with FastCGI
+ support (such as apache with mod_fcgi or fcgid). Below is a sample
+ configuration using Apache2 with fcgid in a dynamic configuration
+ (as opposed to static or standalone mode). More information on these modes and
+ their configuration can be found at
+ http://search.cpan.org/~bobtfish/Catalyst-Runtime-5.80025/lib/Catalyst/Engine/FastCGI.pm#Standalone_server_mode
+ In Apache's mime.conf, add AddHandler fcgid-script .fcgi (or AddHandler fastcgi-script .fcgi for mod_fcgi)
+
+ And a quick VirtualHost configuration:
+
+ <VirtualHost *:80>
+ ServerName gitalist.yourdomain.com
+ DocumentRoot /path/to/gitalist.fcgi
+ <Directory "/path/to/gitalist.fcgi">
+ AllowOverride all
+ Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
+ Order allow,deny
+ Allow from all
+ </Directory>
+
+ # Tell Apache this is a FastCGI application
+ <Files gitalist.fcgi>
+ #change the below to fastcgi-script if using mod_fcgi
+ SetHandler fcgid-script
+ </Files>
+ </VirtualHost>
+
+ Now to access your gitalist instance, you'll go to gitalist.yourdomain.com/gitalist.fcgi/
+ (DO NOT FORGET THAT TRAILING /). If you'd like a different URL, of course, you'll likely want to use
+ mod_rewrite or equivalent
+
+ If you find the need to do some troubleshooting, you can call http://url_to_gitalist.fcgi?dump_info=1
+ and/or add export GITALIST_DEBUG=1 to the top of you gitalist.fcgi file (just below the shebang line).
+
+ Also, note that Apache will refuse %2F in Gitalist URL's unless configured otherwise. Make sure
+ "AllowEncodedSlashes On" is in your httpd.conf file in order for this to run smoothly.
+
CONTRIBUTING
Patches are welcome, please feel free to fork on github and send pull
requests, send patches from git format-patch to the bug tracker, or host