I’ve mentioned Octopress in two recent posts. Now for a brief explanation of what it is and what it includes.

Octopress 2.0

Octopress in version 2.0 was a framework for Jekyll. Out of the box, it provided everything you needed to set up your blog: a predefined configuration, HTML5 templates, theming with Compass and Sass, mobile-first responsive layout, a collection of plugins, and an easy deployment mechanism.

While all of this was very convenient, there were a few problems, mainly:

Octopress (2.0) is basically some guy’s Jekyll blog you can fork and modify.

Brandon Mathis

In addition, some other problems are:

  • Distributing software using Git (on GitHub, in this case) can result in conflicts when you update your site.
  • The Octopress 2.0 distribution is a collection of plugins and configurations which are difficult to change or remove.
  • The theme layer is baked into Octopress and there’s no adequate system to distribute themes independently.
  • Octopress appears not to be part of the Jekyll community.

Octopress 3.0

This latest version solves all of the problems that made the previous one so difficult to update and work with by taking a new approach. Instead of being a framework based on the developer’s blog, Octopress 3.0 is now a powerful, “obsessively designed,” toolkit for creating and deploying Jekyll blogs. It consists of a collection of Ruby Gems which provide functionality for creating posts and pages, specify and use custom templates for posts, and easily deploy your site. A new system for viewing documentation is also included.

The Octopress 2.0 Rakefile has been replaced by a new Command Line Interface (CLI) which enables you to:

  • Easily create posts, pages, drafts, and collections
  • Publish or unpublish drafts
  • Use custom templates for posts and pages
  • Easily deploy your site

A new collection of Plugins is also included which provide functionality for image handling, quotes and pullquotes, a sitemap, and many others. These plugins can be used with Octopress or with any Jekyll site.

This site was converted from my Octopress 2.0 site and is, of course, now using Octopress 3.0.