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

Brit Butler 795f568aea Track the original filepath for all content. 11 년 전
docs e17d2a27df Update the post-receive script to pass the previous revision to Coleslaw. 11 년 전
examples e17d2a27df Update the post-receive script to pass the previous revision to Coleslaw. 11 년 전
plugins 975be4236e Fix style-warnings for static-pages plugin. 11 년 전
src 795f568aea Track the original filepath for all content. 11 년 전
tests 58b37dc630 I really need to write some more tests. 11 년 전
themes 0912413f11 Go ahead and actually link to Coleslaw in the base template. 11 년 전
.gitignore a698389c42 Implement DEPLOY, package updates, minor tweaks. 13 년 전
LICENSE 499453f622 Add BSD License file. 12 년 전
NEWS.md 162df3593d One more NEWS note. 11 년 전
README.md 4599305acf example sites update 11 년 전
TODO 862d7ad066 Update templates to match posts->content. 11 년 전
coleslaw.asd e17d2a27df Update the post-receive script to pass the previous revision to Coleslaw. 11 년 전

README.md

coleslaw

coleslaw logo

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 aims to be flexible blog software suitable for replacing a single-user static site compiler such as Jekyll.

Features

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:

  1. Setup git and create a bare repo as shown here.
  2. Install Lisp (we recommend SBCL) and Quicklisp.
  3. wget -c https://raw.github.com/redline6561/coleslaw/master/examples/example.coleslawrc -O ~/.coleslawrc # and edit as necessary
  4. wget -c https://raw.github.com/redline6561/coleslaw/master/examples/example.post-receive -O your-blog.git/hooks/post-receive # and edit as necessary
  5. chmod +x your-blog/.git/hooks/post-receive
  6. 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
  7. 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.