Skip to content

prb/perpubplat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 ([email protected]) or a patch!

About

Experimental Haskell blog publishing.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published