PAOLO DONADEO PERSONAL BLOG

What is this?

This is the source repository of my personal blog, written in Objective Caml.

License

This software is distributed under the 2-clause BSD license. See the file LICENSE.

Software dependences

The first dependency is Linux. While in principle you should be able to compile and run under Windows and Mac OS X, I never even tried to do so, so all the following instructions are for the Linux OS.

To compile this blog you need the following software and libraries:

• available as Debian/Ubuntu/RedHat packages:

  1. Objective Caml (>= 3.11.1)
  2. Findlib (>= 1.2.4)
  3. OCaml Batteries Included (>= 1.2.0, but probably any recent version)
  4. Ocamlnet (2.2.9)
  5. ocaml-sqlite3 (>= 1.5.1)
  6. Sexplib (>= 4.2.11)
  7. pcre-ocaml (>= 6.0.1)
  8. Cryptokit (>= 1.3)
  9. libssl-ocaml (>= 0.4.3)
  10. Lwt (>= 2.1.0)

• packages you probably must compile and install by hand:

  1. CamlTemplate (1.0.2)

  2. Lwt_equeue. To get a copy of Lwt_equeue:

      $ git clone git://github.com/jaked/lwt-equeue.git
     

Compiling

With the required libraries installed, follow these steps:

1. get the source code:

    $ git clone git://github.com/pdonadeo/personal_blog.git
   

2. compile it:

    $ cd personal_blog/src/
    $ ocamlbuild -j 4 blog.native
    $ cp _build/blog.native blog
   

   "blog" is the executable you need.

3. edit blog_devel.conf and modify the options to match your environments, expecially the paths of doc_root, pid_file and netplex_config;

4. edit netplex_devel.conf. This is the Netplex configuration file and explaining the full syntax is out of scope here. Read the excellent manual for details.

   However, to configure the blog, simply search for all paths in the file and edit them to match your directory tree.

5. run the local HTTP server, for development:

    $ ./blog --config-file `pwd`/blog_devel.conf
   

6. head your browser to: http://localhost:5900/login, you shoud see the login page of the administration.

Customizing the blog (DB explained)

TODO TODO TODO

Configuring Apache

TODO TODO TODO

Running the FastCGI server

TODO TODO TODO