Moved two sites to Octopress

1 minute read

Learn how to migrate a site

A few weeks ago I was planning to undertake a survey of front-end tools but got sidetracked with an overwhelming desire to switch to a CMS-free blogging site at work and home, and so techblog.trunkclub.com and habdas.org have now been migrated to Octopress, a hackers blog, which, when custom tailored, allows for free hosting on GitHub Pages, simple online editing with Prose.io and continuous integration with Travis-CI.

If you’re having problems visualizing, just check out the system diagram.

Handling taxonomy

Migrating to Octopress from sites where tags were used adds the need to carry over more than just categoric taxonomic data. Export tools like the WordPress to Jekyll Exporter should include migrated tags: in the front matter section of the generated md or markdown files in /source/_posts/. But using them requires extra work.

By default, Octopress 2.0 does not include the facilities to handle tags.

To add support for tags to an Octopress install, integrate the octopress-tag-pages plugin including tag pages, tag feed, enhanced archives page and future support for tag clouds.

Migration takeaways

Learning to use and moving to Octopress was a lot of fun, but there were some learnings along the way:

  • When using a migration tool, verify markdown generation quality and consider adjusting complexity of source code to aid the markdown conversion process.
  • Ensure the taxonomy you think you’re getting is supported by your blog, and add support for tagging as necessary.

What’s next

Now that the two blogs are migrated it’s time to get back to the front-end tech survey. That is, until another distraction surfaces.

Leave a Comment