From ac91adcb4be817b5c420f2a6e7052eec1dfbf0c3 Mon Sep 17 00:00:00 2001 From: Tom Willemse Date: Tue, 1 Sep 2015 00:16:00 +0200 Subject: [PATCH] Add post --- introducing-ox-coleslaw.org | 39 ++++++++++++++++++++++++++ introducing-ox-coleslaw.post | 53 ++++++++++++++++++++++++++++++++++++ 2 files changed, 92 insertions(+) create mode 100644 introducing-ox-coleslaw.org create mode 100644 introducing-ox-coleslaw.post diff --git a/introducing-ox-coleslaw.org b/introducing-ox-coleslaw.org new file mode 100644 index 0000000..4cb1e9f --- /dev/null +++ b/introducing-ox-coleslaw.org @@ -0,0 +1,39 @@ +#+TITLE: Introducing ox-coleslaw +#+DATE: 2015-08-05 +#+COLESLAW_TAGS: meta, ox-coleslaw, emacs, cask, tekuti, projects, org-mode + +I have a big problem: I can't write a blog in anything other than [[http://orgmode.org/][Org +mode]]. I have another problem: I haven't found a good way to write a +blog only in Org mode. This always keeps me going back and forth +between blogging systems. I've used [[http://wingolog.org/projects/tekuti/][tekuti]], [[https://wordpress.org/][WordPress]], and I've tried +a few others. Currently I'm using [[https://github.com/kingcons/coleslaw][Coleslaw]]. I haven't written anything +lately though because it supports Markdown and HTML and I was getting +antsy for some Org mode again. So I've been on the lookout for +something new. + +Well... *I've had enough*. I'm not going away this time. I'm going to +fix my problems and commit to this system. I picked Coleslaw because +it's written en Common Lisp and has some interesting features. I'm +going to write an exporter for org to whatever Coleslaw needs! + +I've known that it's pretty easy to write an exporter for Org mode for +some time, but I've never actually tried to write one. I modified some +bits and bobs on [[https://github.com/ryuslash/org-blog][org-blog]], but that didn't really work out. Today +though, while reading an old(er) post on [[http://endlessparentheses.com/how-i-blog-one-year-of-posts-in-a-single-org-file.html?source=rss][Endless Parentheses]], I ran +into [[https://github.com/yoshinari-nomura/org-octopress/blob/master/ox-jekyll.el][ox-jekyll]]. Jekyll has a pretty similar page/post definition +syntax to Coleslaw, so it seemed easy to read what they're doing and +copy the relevant parts. It's a very small Emacs Lisp file, which made +it very easy. So congrats to them and the people writing Org mode for +making some very clear code. + +So I wrote (or copied) [[https://github.com/ryuslash/ox-coleslaw][ox-coleslaw]] based on ox-jekyll. It's slightly +smaller than ox-jekyll because, frankly, it offers less. I just need a +simple way to export a =.org= file to a =.post= file, nothing fancy. + +To write posts I will use Org mode. Once ox-coleslaw is loaded I use +the org export function to export it to an HTML file with the proper +header. You can also do this non-interactively from, for example, a +Makefile, but that is a story for another time. + +This document is the first attempt at publishing a blog post using +ox-coleslaw. diff --git a/introducing-ox-coleslaw.post b/introducing-ox-coleslaw.post new file mode 100644 index 0000000..9499ce2 --- /dev/null +++ b/introducing-ox-coleslaw.post @@ -0,0 +1,53 @@ +;;;;; +title: Introducing ox-coleslaw +date: 2015-08-05 +tags: meta, ox-coleslaw, emacs, cask, tekuti, projects, org-mode +format: html +;;;;; +

+I have a big problem: I can't write a blog in anything other than Org +mode. I have another problem: I haven't found a good way to write a +blog only in Org mode. This always keeps me going back and forth +between blogging systems. I've used tekuti, WordPress, and I've tried +a few others. Currently I'm using Coleslaw. I haven't written anything +lately though because it supports Markdown and HTML and I was getting +antsy for some Org mode again. So I've been on the lookout for +something new. +

+ +

+Well… I've had enough. I'm not going away this time. I'm going to +fix my problems and commit to this system. I picked Coleslaw because +it's written en Common Lisp and has some interesting features. I'm +going to write an exporter for org to whatever Coleslaw needs! +

+ +

+I've known that it's pretty easy to write an exporter for Org mode for +some time, but I've never actually tried to write one. I modified some +bits and bobs on org-blog, but that didn't really work out. Today +though, while reading an old(er) post on Endless Parentheses, I ran +into ox-jekyll. Jekyll has a pretty similar page/post definition +syntax to Coleslaw, so it seemed easy to read what they're doing and +copy the relevant parts. It's a very small Emacs Lisp file, which made +it very easy. So congrats to them and the people writing Org mode for +making some very clear code. +

+ +

+So I wrote (or copied) ox-coleslaw based on ox-jekyll. It's slightly +smaller than ox-jekyll because, frankly, it offers less. I just need a +simple way to export a .org file to a .post file, nothing fancy. +

+ +

+To write posts I will use Org mode. Once ox-coleslaw is loaded I use +the org export function to export it to an HTML file with the proper +header. You can also do this non-interactively from, for example, a +Makefile, but that is a story for another time. +

+ +

+This document is the first attempt at publishing a blog post using +ox-coleslaw. +