octopress reloaded

January 03, 2015

I recently upgraded my home hardware from an Asus 10.1” netbook to a 15” MacBook Pro, and once I adjusted to being able to open more than one window at a time, I got down to the business of loading my files and projects on the new machine. Thanks to Dropbox and Github, most of that work happens either behind the scenes or as needed. Recreating the right environment for each project is still ongoing, and the first challenge I encountered was reloading my blog — started about two years ago using Octopress.

Octopress is an awesome framework built on jekyll. The learning curve for getting started with jekyll was a little steep (liquid layouts, yaml, not to mention design and UX were all new to me then) , and Octopress delivers on its promise to make it easy: just clone, bundle, and blog. Part of what makes Octopress so awesome is the deploy strategy: static pages are generated from yaml and markdown sources (saved in the source branch), and the pages are checked in to your github or heroku repository (as the master branch).

When you clone the repo, you get both branches, but you have to do a little setup to ensure that master is pulling from and pushing to the right place. Borrowing some code from the setup rake task:

$ git clone git@github.com:username/username.github.com.git my_blog
$ cd my_blog
$ git checkout source
$ mkdir _deploy
$ cd _deploy
$ git init
$ git remote add origin git@github.com:username/username.github.com.git
$ git pull origin master
$ cd ..
$ bundle install
$ bundle exec rake preview

Now I have no excuses to not blog more often… well, fewer excuses (thanks to Daniel Doubrovkine for pointing me in the right direction).

I briefly considered switching to a hosted blogging platform (tumblr or wordpress), so I conducted an informal survey (sample size taken from Digital Ocean’s 20 developers to follow) to see what choices leading developers were making, and it looks like a jekyll based blog is still the most popular. What is yours?

platform users
jekyll 6
octopress 3
none 3
tumblr 1
hand-rolled 6
wordpress 1

Katie Leonard

Mostly Katie explaining things to herself.

© 2025