#staticsitegenerator

Tl;dr: Don't bother switching. Tumblr is better.

Guys, my blog is failing.

I've been blogging (via Tumblr) at http://www.rogueleaderr.com for two years and the Google analytics data speaks for itself:

Except for one random post about subverting Megabus wifi, my posts hardly ever see more than 200 hits (few of whom actually read to the end). I'm grateful for the readers I have, but I'm only getting marginally more amplification than shouting from a literal soapbox.

So I've decided to step up my blogging game

I've got some ideas I want to spread. And it's time to find out whether no one else cares about those ideas or whether I'm just doing a bad job of broadcasting.

So I'm taking a few steps to step things up:

Creating an email newsletter. (You can sign up here)

Getting serious about promoting my blog posts.

Redesigning my blog.

1 & 2 are topics for a different day. This post is about #3, my decision to switch from trusty Tumblr to a static website generator.

Spoiler: I will be wrecked by "what you know you know that just ain't so…"

I should have listened to Mark Twain. That's the main moral of this story. The longer story is that I let bad assumptions waste quite a lot of my time.

If you spent any time on Hacker News et al., you're probably familiar with the classic "hacker profile page", as best exemplified by Tom Preston-Werner or Kenneth Reitz or Paul Graham. These inimitably classy and minimalist sites generally contain a short tagline-style bio of the hacker, a list of projects, a list of blog posts, and maybe a contact form or easter egg.

I may not have a tenth the skill of any of those chaps, but I know how to steal a good idea when I see one. I wanted my blog to look like theirs and so I assumed (falsely!) that I needed to build my blog the way they built theirs. That meant a static website generator since, after all, Tom Preston-Werner popularized the very idea of static website generators with his tool Jekyll.

If you're not familiar, static website generators (hereafter "SWG's") let you store all the components of your website (including each individual blog post) as files in a directory (often in a markup language like Markdown). You run a script and presto everything is compiled to interlinked HTML files which can be uploaded and served directly from a webserver or even for free from Github.

Static is the move.

As I started researching SWG's, I quickly realized that there are a lot of options. The most popular seems to be the Ruby-based Jekyll, the original heavy weight. I read Ruby at a 3rd grade level and SWG's in general seem to require a lot of tweaking, so I was inclined to prefer a Python-based option.

There are plenty of those as well, but I found a glowing post about one called Pelican so, in the absence of any clear compelling differences among the options, I decided Pelican was the way to go. It's pretty simple to setup a basic Pelican site and even to deploy it publicly on Github Pages (probably 30 minutes work.) But a few minutes later, the problems started.

First, I wanted to create an "About Me" page. That's quite easy, if you already know how to do it. If you don't the Pelican docs (and limited tutorials available online) require some pretty close study.

Next, I wanted to make my blog pretty. Pelican ships with some off the shelf themes. IMHO, they're all somewhere between ugly and "meh." So I hoped over to CreativeMarket (with a big discount from AppSumo burning a whole in my pocket) and looked for a theme. There are hundreds of Wordpress and Tumblr themes for sale, but nothing for Pelican and only a few for "generic HTML site". Before accepting the cost of customizing one of those to fit Pelican, I googled and found a generic Svbtle ripoff theme for Pelican.

Sure it's not responsive, but only 7% of my traffic is mobile. So…goodbye forever iPhone losers!

I need to build a link to the past

Next problem: my blog gets a small but non-trivial amount of inbound search traffic. Simply shutting down the old site would kill all traffic to those archives. So I needed to import my posts from Tumblr. But as I've learned the hard way on my current project LinerNotes, Googlebot ain't too bright. Even if I redirect the rogueleaderr.com domain to my pretty new static site, any change in the URL's of my old posts will at least break any external links to my posts and at worst will cause Google to penalize my posts as both broken links and duplicate content. Plus, cool URI's don't change.

A site deployed behind a webserver like nginx could use URL rewrites to redirect incoming URL's (assuming the URL slugs could be preserved). But…Github pages doesn't allow redirects (except perhaps via Javascript; I never got that far.)

And I'm back to Tumblr

While googling for how to import from Tumblr to Pelican, I stumbled upon a Tumblr manual page and had a massive facepalm moment.

It turns out that Tumblr has a feature called "Pages" that lets you include and link to static pages right inside your Tumblog.

All you have to do is press a button and drop in a little HTML and you've got your own "About Me" page. In other words, basically all the customization power I was hoping to get from a static site is already available in Tumblr with none of the hassle of learning how to use a generator, managing the migration, and maintaining a separate site.

With about 45 minutes of work and the help of the Tumblr Svblte Theme, I was able to create a site that looked and worked better than my Pelican site and preserved all my lovely links and Tumblr followers.

And it's even responsive.

Moral of the story

Tumblr is a lot more powerful than I realized (as probably is Wordpress, which I haven't used). And Tumblr gives you an awful lot of bang for the setup buck. I'm now struggling to think of a use case that SWG's allow and Tumblr doesn't. (Maybe if you want lots of highly customized static pages, or if you want to run a webserver with complicated URL trickery.) If you're publishing a lot of varied types of content, you'll probably be better served by a fullblown CMS. SWG's are only marginally less complicated to learn.

I've read worries about "what if Tumblr dies off like Posterous" -- well, Tumblr allows export of your posts via an API, so you can deal with learning Pelican as soon as Yahoo writes off its $1bln investment.

One good argument I've heard is that storing a blog in a directory allows version control. That's true, but I basically never change old posts. And it's easy enough to save a copy of the HTML of a Tumblr theme before changing it.

All in all, the hassles of a Static Website Generator don't outweight the costs.

Think I'm crazy? Let's talk it out in the comments.

Did you like this post?