Remove the massive chunk of crud to do application/xhtml+xml detection and replace...

[catagits/Gitalist.git] / README

Gitalist - a transitional project to convert gitweb.cgi to a Catalyst app.

The idea behind this project is to move gitweb.cgi away from a single
monolithic CGI script and into a modern Catalyst app. Fortunately this is not
as daunting as it might seem at first as gitweb.cgi follows an MVC type
structure. Once gitweb.cgi has been suitably Catalysed then it can move from
being a "this was once gitweb.cgi" to a project of its own (hence the
"transitional" in the description).

As it stands Gitalist is very much in its infancy and hasn't got far
beyond a layout template and a single controller. Probably the next step is
moving an existing action into a new Catalyst action and lay down the code
to make porting further actions, or writing new ones, as simple as possible.
After that provide a model based on one of the git modules, either the Git.pm
that comes with git or Git::PurePerl, and deprecate or port the existing
gitweb.cgi functions.

USAGE

To get Gitalist up and running just set $projectroot in gitweb.conf to point
to the directory that contains your repositories. With that done just run:

  perl script/gitalist_server.pl

DEPENDENCIES

  Catalyst
  IO::Capture::Stdout;

COPYRIGHT AND LICENCE

Copyright (C) 2009 Venda Ltd

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.

gitweb.pm is based on the gitweb.perl from git-1.6.3.3
(C) 2005-2006, Kay Sievers <kay.sievers@vrfy.org>
(C) 2005, Christian Gierke