X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=9ba448a711ecbf75fbb87b39082f2de435000a63;hb=df06d2a1f740e96af324cc839d4300bba7c8228a;hp=5af42e7526f7ea3936ec29e2e7144acc1d59bdc1;hpb=2db4bce7abf77be479a6a6c62c8e08c5067d0c6d;p=catagits%2FGitalist.git diff --git a/README b/README index 5af42e7..9ba448a 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 - and backed by Catalyst. + Gitalist is a web frontend for git repositories based on gitweb.cgi + 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 or as pure Perl with - Catalyst::Engine::PreFork. + Gitalist can also be run under mod_perl 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 @@ -152,8 +152,6 @@ CONFIGURATION about leaking repo names via the browser referer headers. Model::CollectionOfRepos - git Path to the "git" binary. - repo_dir A directory containing the directories to show. @@ -177,17 +175,29 @@ CONFIGURATION If provided every must contain a file of the same name to be visible. This is similar to "gitweb"'s functionality. + class + If you want a different way of surfacing repositories you can use + your own model (i.e something that composes + Gitalist::Git::CollectionOfRepositories) and specify the class name + with this config option. + + args + Any additional arguments to be passed into the Model constructor, + only of use when used in conjunction with "class" (see above). + paging log The number of commits to show in the summary, shortlog and longlog views. FASTCGI Running Gitalist in FastCGI mode requires a webserver with 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. + 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. In Apache's mime.conf, add "AddHandler fcgid-script .fcgi" (or "AddHandler fastcgi-script .fcgi" for mod_fcgi). @@ -214,7 +224,8 @@ 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 or equivalent. + 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