Flexible Lisp Blogware. Fork for personal use. Mirrored from https://github.com/kingcons/coleslaw originally.

Nathaniel Smith caaac152cc fix link to chiptheglasses		vor 10 Jahren
docs	4896f31596 Merge pull request #51 from redline6561/experimental	vor 11 Jahren
examples	6a4b26c9bb Add default lang and charset values to the config.	vor 11 Jahren
plugins	37a1d7ad6a Comment tweaks.	vor 11 Jahren
src	8304e6b74b More robust directory changing	vor 10 Jahren
tests	58b37dc630 I really need to write some more tests.	vor 11 Jahren
themes	b29d45e3a4 Fix validation errors.	vor 10 Jahren
.gitignore	a698389c42 Implement DEPLOY, package updates, minor tweaks.	vor 13 Jahren
LICENSE	499453f622 Add BSD License file.	vor 12 Jahren
NEWS.md	e4f3ee06ec Last minute NEWS tweak to sneak this into 0.9.5/Quicklisp June 2014.	vor 11 Jahren
README.md	caaac152cc fix link to chiptheglasses	vor 10 Jahren
TODO	862d7ad066 Update templates to match posts->content.	vor 11 Jahren
coleslaw.asd	733a8a82ad Add one more docs note, call it 0.9.5.	vor 11 Jahren

coleslaw

Czeslaw Milosz was the writer-in-residence at UNC c. 1992. I used to see him all the time at the Hardback Cafe, always sitting at a two-top drinking coffee, reading, writing, eating chips and salsa. I remember a gentleness behind the enormous bushy eyebrows and that we called him Coleslaw. - anon

Coleslaw is Flexible Lisp Blogware similar to Frog, Jekyll, or Hakyll.

Features

Git for storage
RSS and Atom feeds
Markdown Support with Code Highlighting provided by colorize
- Currently supports: Common Lisp, Emacs Lisp, Scheme, C, C++, Java, Python, Erlang, Haskell, Obj-C, Diff.
A Plugin API and plugins for...
- Static Pages
- Sitemap generation
- Incremental builds
- Analytics via Google
- Comments via Disqus
- Hosting via Github Pages, Heroku, or Amazon S3
- Tweeting about new posts
- Using LaTeX via Mathjax
- Writing posts in ReStructured Text
- Importing posts from Wordpress
There is also a Heroku buildpack maintained by Jose Pereira.

Example Sites

Hacking

A core goal of coleslaw is to be both pleasant to read and easy to hack on and extend. If you want to understand the internals and bend coleslaw to do new and interesting things, I strongly encourage you to read the Hacker's Guide to Coleslaw.

Installation

This software should be portable to any conforming Common Lisp implementation but testing is primarily done on SBCL and CCL. Server side setup:

Setup git and create a bare repo as shown here.
Install Lisp (we recommend SBCL) and Quicklisp.
wget -c https://raw.github.com/redline6561/coleslaw/master/examples/example.coleslawrc -O ~/.coleslawrc # and edit as necessary
wget -c https://raw.github.com/redline6561/coleslaw/master/examples/example.post-receive -O your-blog.git/hooks/post-receive # and edit as necessary
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
Point the web server of your choice at the symlink /path/to/deploy-dir/.curr/

Now whenever you push a new commit to the server, coleslaw will update your blog automatically! You may need to git push -u prod master the first time.

The Post Format

Coleslaw expects post files to be formatted as follows:

;;;;;
title: foo
tags: bar, baz
date: yyyy-mm-dd hh:mm:ss
format: html (for raw html) or md (for markdown)
;;;;;
your post

Theming

Two themes are provided: hyde and readable (based on bootswatch readable). Hyde is the default. A guide to creating themes for coleslaw lives here.

README.md