X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=5af42e7526f7ea3936ec29e2e7144acc1d59bdc1;hb=refs%2Ftags%2F0.003005;hp=33e62bde3dc975ddb65e845b248a1ef28f185298;hpb=225bd36dbf284adf49ae0bffe0fc482f228c0011;p=catagits%2FGitalist.git diff --git a/README b/README index 33e62bd..5af42e7 100644 --- a/README +++ b/README @@ -23,8 +23,8 @@ INSTALL repositories the directory above the checkout. DESCRIPTION - Gitalist is a web frontend for git repositories based on gitweb.cgi - and backed by Catalyst. + Gitalist is a web frontend for git repositories based on + and backed by Catalyst. History This project started off as an attempt to port *gitweb.cgi* to a @@ -122,8 +122,8 @@ RUNNING than using the single threaded developement server. The recommended deployment method for Gitalist is FastCGI, although - Gitalist can also be run under mod_perl or as - pure Perl with Catalyst::Engine::PreFork. + Gitalist can also be run under or as pure Perl with + Catalyst::Engine::PreFork. Assuming that you have installed Gitalist's dependencies into a local::lib, and you are running from a git checkout, adding a trivial @@ -147,6 +147,10 @@ CONFIGURATION The Gitalist config is loaded with Catalyst::Plugin::ConfigLoader and the available config options are: + no_gravatars + If true don't display gravatars. May be desirable if you are worried + about leaking repo names via the browser referer headers. + Model::CollectionOfRepos git Path to the "git" binary. @@ -179,13 +183,11 @@ CONFIGURATION FASTCGI Running Gitalist in FastCGI mode requires a webserver with FastCGI - support (such as apache with mod_fcgi - or mod_fcgid - ). Below is a sample configuration - using Apache2 with mod_fcgid in a dynamic configuration (as opposed to - static or standalone mode). More information on these modes and their - configuration can be found at "Standalone server mode" in - Catalyst::Engine::FastCGI. + support (such as apache with or ). Below is a + sample configuration using Apache2 with mod_fcgid in a dynamic + configuration (as opposed to static or standalone mode). More + information on these modes and their configuration can be found at + "Standalone server mode" in Catalyst::Engine::FastCGI. In Apache's mime.conf, add "AddHandler fcgid-script .fcgi" (or "AddHandler fastcgi-script .fcgi" for mod_fcgi). @@ -212,17 +214,22 @@ CONFIGURATION 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. + use 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 your gitalist.fcgi file (just below the shebang line). - Also, note that Apache will refuse %2F in Gitalist URLs unless - configured otherwise. Make sure "AllowEncodedSlashes On" is in your - httpd.conf file in order for this to run smoothly. + Apache config + Apache will refuse %2F in Gitalist URLs unless configured otherwise. + Make sure "AllowEncodedSlashes On" is in your httpd.conf file in order + for this to run smoothly. + + To have the static content served statically by Apache, instead of + Gitalist, then add something like following line to your httpd.conf: + + Alias /static /usr/local/share/perl/5.10.1/Gitalist/root/static CONTRIBUTING Patches are welcome, please feel free to fork on github and send pull