Using Jekyll to publish Org mode texts

This repository documents how to setup a Jekyll site that is able to export Org mode files, as well as the flow that I use for publishing them.

Setup

Install Jekyll and also (optionally) re-org for creating new Org files based on templates.

gem install jekyll
gem install re-org

Now fetch the OrgJekyll submodule that would enable us stop using the YAML front matter and instead rely on Org mode syntax:

git submodule init
git submodule update

Creating a new writing

re-org new jekyll-post --title=hello-world

Would create this file in _drafts/2013-12-09-hello-world.org:

#+title:         Hello world
#+date:          2013-12-09
#+layout:        post
#+category:      posts

,Your content would go here!

Once you are done writing, publish and render it with jekyll server --drafts. Or in case your writing is already done:

mv _drafts/2013-12-09-hello-world.org _posts/
jekyll server

Then just publish the generated HTML in _site on the hosting of your preference.

Hope this helps!