-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
92 lines (54 loc) · 2.38 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
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!