Josh Thompson     About     Archive

Switching to Jekyll

A few days ago, I was really feeling the urge to write a short little blog post. So, I put it in a gist on Github.

I’m an advocate of writing publicly, and making it a habit, so why was I putting it in a gist, instead of here, on my website, where I theoretically can write and publish anything I want?


It’s very easy for me to sketch out a quick document with embedded screenshots in a text editor. I spend most of my day in a text editor anyway, so it’s trivially easy to write a new document.

I can add code snippets, links, images, and have nicely formatted text, just the way that I like it, in a gist.

SquareSpace, the service I was using for my website, is not designed for people who write in Markdown. SquareSpace is very good at many things, but not the things I needed. Practically Efficient says it better than I can.

So, last week, I decided that if I didn’t make my writing and publishing easy, I would probably just stop writing.

Migrating to Jekyll

Jekyll is a “blog-aware static site generator that can run on Github Pages” (source).

All of these check off the “nice-to-have” boxes I’d look for. And now that I’m spending all day writing code, and inside of a text editor, and using Github, getting to merge my Git workflow with blogging is sorta perfect.

Plus, Jekyll is written in Ruby, so it has lots of pieces I’m quite familiar with by now.

I pulled from lots of articles others had written, to figure out all sorts of little tweaks. Here’s the list that I drew most heavily from:

Jekyll Migration Resources

And that’s about it. It’s been an amazing experience, porting everything over to Jekyll.

There are still some modifications I want to make, like how code snippets run off the edge of the page if the lines are long, but this is lower priority.

There’s still plenty for me to learn with Jekyll, but I’m getting there.

Until then, I’ll probably be posting a lot more online. Since it’s so easy.

Get occasional emails

If there are new posts, you'll get an email with summaries that Friday. If not, you'll not hear from me.