Templating with Jekyll

May 31, 2014

Hosting a static content weblog on Github (or any server) is relatively straight forward. Author your content → commit → push. After a few posts about your favorite programming language, your cat and that new restaurant you went to, you start noticing your workflow becomes copy page layout from another page → edit page to include your new content → save. Thats not inherently bad. Some content may be that static and simple.

Pain points arise when the content author wants to change something after they have authored a substantial number of pages. Find → Replace may work for simple cases however it wont help if you want to change layout. Ideally changes to content and layout should be orthogonal. Templating engines facilitate the separation necessary for the content and layout to change independently. The upfront work of selecting a template engine and a consistent taxonomy of structural and stylistic elements pays dividends.

Jekyll is the default templating engine or rather "static site generator" for Github pages. Have a look under the hood to see how I'm using it.