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

Brit Butler e57f350cb4 Base template cleanup, flesh out config sitenav handling.		пре 12 година
docs	a8642c98c7 Flesh out README.	пре 12 година
plugins	25aae81312 Add a symlink for index.html, update mathjax config.	пре 12 година
src	26b7e1b866 Make RSS and ATOM templates theme-agnostic.	пре 12 година
tests	8c0b1f8697 Rework ASDs, add stub md+rst plugins, docs script, and stub tests.	пре 13 година
themes	e57f350cb4 Base template cleanup, flesh out config sitenav handling.	пре 12 година
.gitignore	a698389c42 Implement DEPLOY, package updates, minor tweaks.	пре 13 година
README.md	cfe0f41581 Update install notes now that my colorize fork and coleslaw are in the next QL release.	пре 12 година
TODO	f65a952a89 TODO updates, Minor RENDER-PAGE tweak.	пре 12 година
coleslaw.asd	aa0ddff149 Version bump to 0.6. Move LOAD-PLUGINS into config file. Minor cleanups.	пре 12 година
example.coleslawrc	0be1db7890 Tweak deploy code since post-receive kills $TMP_CLONE_REPO.	пре 12 година
example.post-receive	467f81098b Use trivial-shell's portable EXIT.	пре 12 година
gen-docs.sh	8c0b1f8697 Rework ASDs, add stub md+rst plugins, docs script, and stub tests.	пре 13 година
logo_large.jpg	524c8a4851 Neil was kind enough to make me a logo. Good fun in small, medium and large.	пре 14 година
logo_medium.jpg	524c8a4851 Neil was kind enough to make me a logo. Good fun in small, medium and large.	пре 14 година
logo_small.jpg	524c8a4851 Neil was kind enough to make me a logo. Good fun in small, medium and large.	пре 14 година

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

Features

Git for storage
RSS feeds!
Markdown Support with Code Highlighting provided by colorize.
- Currently supports: Common Lisp, Emacs Lisp, Scheme, Clojure, C, C++, Java, Python, Erlang, Haskell, Obj-C, Diff.
Plugins to...
- Use LaTeX (inside pairs of $$) via Mathjax
- Import from wordpress

Installation

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.
Install Lisp and Quicklisp.
wget -c https://raw.github.com/redline6561/coleslaw/master/example.coleslawrc -O ~/.coleslawrc # and edit as necessary
wget -c https://raw.github.com/redline6561/coleslaw/master/example.post-receieve -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 timestamp
format: html (for raw html) or md (for markdown)
;;;;;
your post

Importing from Wordpress

There is a "plugin" to import from wordpress. At some point, it should be turned into a standalone script. Until then...

Export your posts from wordpress.
In your lisp of choice, do the following:
1. (ql:quickload 'coleslaw)
2. (in-package :coleslaw)
3. (load-plugins '(import))
4. (coleslaw-import::import-posts "/path/to/export.xml")

The XML will be read and placed into .post files in the :repo location specified in your .coleslawrc.

Writing your own plugins

For now, see the API and the mathjax plugin for an example. A proper guide about this will be written later.

Theming

A default theme, hyde, is provided. Themes are made using Google's closure-template and the source for hyde should be simple and instructive until I can provide better docs.

README.md