Jekyll is a tool for static site generation, and it’s what powers Github pages, both of which generate and host this site, respectively.
It’s a fantastic tool for hackers to create simple, and fast (see static site, above) blogs using minimal configuration, the Liquid templating engine for layout, and markdown for posts.
I had previously used Wordpress as my blogging platform of choice, like so many others, and came to Jekyll because of it’s simplicity, it’s speed, and it’s hackability, not to mention that as a Github user, you are entitled to a free Jekyll (or static HTML) site hosted on their blazing fast setup.
One minor pain point for me, is when creating a new post in Jekyll, you need to create a new file in the following convention: title-of-your-post-year-month-day.md
. In addition, each post needs some meta data at the top of the markdown file.
Now, this could all be typed out each time without too much time being eaten up, but we’re programmers, damn it, so why do things manually when they can be reasonably automated? To the shell!
#!/bin/bash
# Create a new post for a Jekyll blog.
cd /path/to/your/jekyll/repo/_posts
FILETILE=$(echo "$1" | tr " " "-" | tr '[:upper:]' '[:lower:]')
POSTDATE=$(\date +"%Y-%m-%d")
POSTNAME=$POSTDATE-$FILETILE.md
POSTBODY="---
layout: post
title: $1
date: $POSTDATE $(\date +"%H:%M:%S")
summary:
categories:
---"
cat <<EOF >> $POSTNAME
$POSTBODY
EOF
open "$POSTNAME"
This code is also available as a gist.
To use the script, just download it, modify the path on the cd /path/to/your/jekyll/repo/_posts
line to point to your Jekyll installation’s _posts
directory, and save the script somewhere in your PATH
.
Now, if you saved the file as new_post
for example, you can call it like, new_post "My Sick Blog Post"
, and an appropriately named file with most of the meta data filled out will appear in your _posts
directory.
Not only that, but it will immediately launch the default editor for markdown files, so you can start writing straight away!
Enjoy.