Sākums Izpētīt Palīdzība
Pierakstīties
azra
/
coleslaw
spogulis no https://gitlab.com/azrazalea/coleslaw
Vērot 1
Pievienot zvaigznīti 0
Atdalīts 0
Kods Problēmas 0 Revīzijas 260 Laidieni 0 Vikivietne

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

Koks: 6396e136d3
Atzari Tagi
coleslaw
Do Nhat Minh 6396e136d3 first pass in adding github integration 12 gadi atpakaļ
docs 09d54e4863 Mathjax plugin cleanups. 12 gadi atpakaļ
examples 60ad551523 Simplify plugin loader. 12 gadi atpakaļ
plugins 94420c9d4e Tiny improvement, do not emit text/x-math-config script section if not needed 12 gadi atpakaļ
src 6396e136d3 first pass in adding github integration 12 gadi atpakaļ
tests 8c0b1f8697 Rework ASDs, add stub md+rst plugins, docs script, and stub tests. 13 gadi atpakaļ
themes dbdb7e29af Allow arbitrary tag names. However if two tags have the same slug they will be merged. 12 gadi atpakaļ
.gitignore a698389c42 Implement DEPLOY, package updates, minor tweaks. 13 gadi atpakaļ
LICENSE 499453f622 Add BSD License file. 12 gadi atpakaļ
NEWS.md 0aef123193 NEWS updates. 12 gadi atpakaļ
README.md 818def3629 Release: 0.9! 12 gadi atpakaļ
TODO 13a7a7dc65 Cleanup make-pubdate based on information from cl-test-grid. Thanks Fare! 12 gadi atpakaļ
coleslaw.asd 08ac715884 Cleanups to new-tags. Fixes Issue #27. 12 gadi atpakaļ
gen-docs.sh 8c0b1f8697 Rework ASDs, add stub md+rst plugins, docs script, and stub tests. 13 gadi atpakaļ

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

  • 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.

  • Multi-site publishing support.

  • A Plugin API and plugins for...

    • Comments via Disqus
    • Analytics via Google
    • Deploying to Amazon S3.
    • Using LaTeX (inside pairs of $$) via Mathjax
    • Using ReStructured Text
    • Importing posts from wordpress

  • There is also a Heroku buildpack maintained by Jose Pereira.

  • Example sites: redlinernotes and (lisp :is 'fun).

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:

  1. Setup git and create a bare repo as shown here.
  2. Install Lisp and Quicklisp.
  3. wget -c https://raw.github.com/redline6561/coleslaw/master/examples/single-site.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

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.