|
<p>Coleslaw aims to be flexible blog software suitable for replacing a single-user static site compiler such as Jekyll.</p>
<p>Full docs coming soon...</p>
<p>Features:</p>
<ul>
<li>Git for storage</li>
<li>RSS feeds!</li>
<li>Plugins to...
** Import from wordpress
** Use Mathjax/LaTeX</li>
</ul>
<p>Forthcoming:</p>
<ul>
<li>Markdown support</li>
<li>RST support</li>
<li>Host on Amazon S3</li>
<li>Code highlighting</li>
</ul>
<p>References:
-- Jekyll
-- Hakyll
-- Hyde</p>
<p>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:</p>
<ul>
<li>Clone or create the git repo for your blog.</li>
<li>Install Lisp and Quicklisp.</li>
<li>For now, git clone <a href="https://github.com/redline6561/coleslaw.git" rel="nofollow">https://github.com/redline6561/coleslaw.git</a> and add
(push "/path/to/coleslaw/" asdf:<em>central-registry</em>) 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.</li>
<li>cp coleslaw/example.coleslawrc ~/.coleslawrc # and edit as necessary for your repo location, deploy location, etc</li>
<li>Edit your-blog/.git/hooks/post-receieve and insert:
sbcl --eval "(progn (ql:quickload :coleslaw) (coleslaw:main) (sb-ext:quit))" # or (sb-ext:exit) on SBCL >= 1.0.57</li>
<li>chmod +x your-blog/.git/hooks/post-receive
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</li>
</ul>
|