|
|
|
|
14
|
* RSS and Atom feeds!
|
14
|
* RSS and Atom feeds!
|
15
|
* Markdown Support with Code Highlighting provided by [colorize](http://www.cliki.net/colorize).
|
15
|
* Markdown Support with Code Highlighting provided by [colorize](http://www.cliki.net/colorize).
|
16
|
* Currently supports: Common Lisp, Emacs Lisp, Scheme, C, C++, Java, Python, Erlang, Haskell, Obj-C, Diff.
|
16
|
* Currently supports: Common Lisp, Emacs Lisp, Scheme, C, C++, Java, Python, Erlang, Haskell, Obj-C, Diff.
|
17
|
-* [Multi-site publishing](http://rmoritz.github.io/articles/coleslaw-multi-site/) support.
|
|
|
18
|
|
17
|
|
19
|
* A [Plugin API](http://github.com/redline6561/coleslaw/blob/master/docs/plugin-api.md) and [**plugins**](http://github.com/redline6561/coleslaw/blob/master/docs/plugin-use.md) for...
|
18
|
* A [Plugin API](http://github.com/redline6561/coleslaw/blob/master/docs/plugin-api.md) and [**plugins**](http://github.com/redline6561/coleslaw/blob/master/docs/plugin-use.md) for...
|
20
|
- * Comments via Disqus
|
|
|
|
|
19
|
+ * Static Pages
|
21
|
* Analytics via Google
|
20
|
* Analytics via Google
|
22
|
- * Hosting via Github Pages
|
|
|
23
|
- * Deploying to Amazon S3
|
|
|
24
|
- * Using LaTeX (inside pairs of $$) via Mathjax
|
|
|
|
|
21
|
+ * Comments via [Disqus](http://disqus.com/)
|
|
|
22
|
+ * Hosting via [Github Pages](https://pages.github.com/), [Heroku](http://heroku.com/), or [Amazon S3](http://aws.amazon.com/s3/)
|
|
|
23
|
+ * Using LaTeX via [Mathjax](http://mathjax.org/)
|
25
|
* Using ReStructured Text
|
24
|
* Using ReStructured Text
|
|
|
25
|
+ * Importing posts from [Wordpress](http://wordpress.org/)
|
26
|
* Sitemap generation
|
26
|
* Sitemap generation
|
27
|
- * Importing posts from wordpress
|
|
|
28
|
|
27
|
|
29
|
* There is also a [Heroku buildpack](https://github.com/jsmpereira/coleslaw-heroku) maintained by Jose Pereira.
|
28
|
* There is also a [Heroku buildpack](https://github.com/jsmpereira/coleslaw-heroku) maintained by Jose Pereira.
|
30
|
* Example sites: [redlinernotes](http://redlinernotes.com/blog/), [kenan-bolukbasi.log](http://kenanb.com/), and [Nothing Really Matters](http://ironhead.xs4all.nl/).
|
29
|
* Example sites: [redlinernotes](http://redlinernotes.com/blog/), [kenan-bolukbasi.log](http://kenanb.com/), and [Nothing Really Matters](http://ironhead.xs4all.nl/).
|
|
|
|
|
34
|
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](https://github.com/redline6561/coleslaw/blob/master/docs/hacking.md).
|
33
|
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](https://github.com/redline6561/coleslaw/blob/master/docs/hacking.md).
|
35
|
|
34
|
|
36
|
## Installation
|
35
|
## Installation
|
37
|
-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.
|
|
|
|
|
36
|
+This software should be portable to any conforming Common Lisp implementation but testing is primarily done on [SBCL](http://www.sbcl.org/) and [CCL](http://ccl.clozure.com/).
|
38
|
Server side setup:
|
37
|
Server side setup:
|
39
|
|
38
|
|
40
|
1. Setup git and create a bare repo as shown [here](http://git-scm.com/book/en/Git-on-the-Server-Setting-Up-the-Server).
|
39
|
1. Setup git and create a bare repo as shown [here](http://git-scm.com/book/en/Git-on-the-Server-Setting-Up-the-Server).
|
41
|
-2. Install Lisp and [Quicklisp](http://quicklisp.org/).
|
|
|
|
|
40
|
+2. Install Lisp (we recommend SBCL) and [Quicklisp](http://quicklisp.org/).
|
42
|
3. ```wget -c https://raw.github.com/redline6561/coleslaw/master/examples/single-site.coleslawrc -O ~/.coleslawrc``` # and edit as necessary
|
41
|
3. ```wget -c https://raw.github.com/redline6561/coleslaw/master/examples/single-site.coleslawrc -O ~/.coleslawrc``` # and edit as necessary
|
43
|
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
|
42
|
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
|
44
|
5. ```chmod +x your-blog/.git/hooks/post-receive```
|
43
|
5. ```chmod +x your-blog/.git/hooks/post-receive```
|
45
|
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```
|
44
|
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```
|
46
|
7. Point the web server of your choice at the symlink /path/to/deploy-dir/.curr/
|
45
|
7. Point the web server of your choice at the symlink /path/to/deploy-dir/.curr/
|
47
|
|
46
|
|
48
|
-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.
|
|
|
|
|
47
|
+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.
|
49
|
|
48
|
|
50
|
## The Post Format
|
49
|
## The Post Format
|
51
|
Coleslaw expects post files to be formatted as follows:
|
50
|
Coleslaw expects post files to be formatted as follows:
|