This file explains how to build perpubplat. This is not for the uninitiated or faint of heart, and I'll assume that you've got a good level of familiarity with Apache (or some other FastCGI container like lighttpd), Haskell, and standard *nix environments. (That said, what you don't know is probably readily available by Googling.) The "per" in perpubplat is for "personal", and I haven't gone out of my way to make perpubplat configurable or customizable beyond my immediate purposes. That said, I do intend to continue making enhancements and customizations. On my roadmap: - Better configuration (properties versus compiled in) - Draft management (AtomPub and web interface) - Threaded comments - HTTP referer management - Component management (turn off sidebar components, etc.) PREREQUISITES You will need: - GHC 6.8.3 - cabal-install (0.5.2 or greater) - FastCGI libraries, installed somewhere your linker will know how to find them. Download the source from http://www.fastcgi.com/ I will track the latest released version of GHC, so expect a bump when new versions of GHC are released. GETTING SOURCE The git repository for perpubplat is hosted at github: http://github.com/prb/perpubplat To clone the repository, do: $ git clone git://github.com/prb/perpubplat.git Or you can ask github to make you a tarball. CONFIGURING All of the relevant configuration parameters are in the Blog.Constants module in the perpubplat library. BUILDING The libraries and executables all build the standard cabal-install way, e.g.: $ cd perpubplat $ cabal install This places the perpubplat.fcgi executable in ~/.cabal/bin. If you want the executable in a different location: $ cd perpubplat $ cabal install --prefix=/path/to/other/location RUNNING Point your favorite FastCGI web container at perpubplat.fcgi. Some help selecting and configuring a container is available from here: http://mult.ifario.us/p/wiring-haskell-into-a-fastcgi-web-server Some sample Apache2 configuration fragments are included in the repository. *** NB: It is critically important that only one perpubplat.fcgi process is running at a time, so configure the web container accordingly. *** BOOTSTRAPPING CONTENT Bootstrapping content is explained in this blog post: http://mult.ifario.us/p/hello-world-for-perpubplat QUESTIONS / COMMENTS / IMPROVEMENTS Feel free to send me an email (prb@mult.ifario.us) or a patch!