coleslaw/README

Coleslaw aims to be flexible blog software suitable for replacing a single-user static site compiler such as Jekyll.

Full docs coming soon...

Features:
* Git for storage
* RSS feeds!
* Plugins to...
** Import from wordpress
** Use Mathjax/LaTeX

Forthcoming:
* Markdown support
* RST support
* Host on Amazon S3
* Code highlighting

References:
-- Jekyll
-- Hakyll
-- Hyde

This software should be portable to any conforming Common Lisp implementation but this guide will assume SBCL is installed. Testing has also been done on CCL.
Server side setup:
* Setup git and create a bare repo as shown [here](http://git-scm.com/book/en/Git-on-the-Server-Setting-Up-the-Server).
* Install Lisp and Quicklisp.
* For now, git clone https://github.com/redline6561/coleslaw.git and add
           (push "/path/to/coleslaw/" asdf:*central-registry*) to your lisp's init file. (e.g. ~/.sbclrc for SBCL)
             -- You may need to (require 'asdf) in that file first or even create it! (Don't panic.)
      This is only temporarily necessary until coleslaw is in quicklisp.
* cp coleslaw/example.coleslawrc ~/.coleslawrc # and edit as necessary for your repo location, deploy location, etc
* cp coleslaw/example.post-receieve your-blog.git/hooks/post-receive
* chmod +x your-blog/.git/hooks/post-receive
* Create or clone your blog repo locally. Add your server as a remote with git remote add prod git@my-host.com:path/to/repo.git
Now whenever you push a new commit to the server, coleslaw will update your blog automatically!
The only thing left to do is point a web server of your choice at the symlink /path/to/coleslaw/.curr