Migrating from Wordpress to Jekyll
static file blogging
I just switched this blog from an ancient version of wordpress running on a VPS to a static-file jekyll bootstrap site (hosted by github). Let me know if you experience any wierdness on the site or feeds. I’ve taken good measures to make sure links don’t break (old URLS should get a 301 permanent redirect to blog.perrygeo.net) but let me know if you get any 404s.
So why do it?
- Having a PHP-MySQL app running on a VPS just to serve up a bunch of blog posts seemed excessive. I don’t have the desire to maintain that sort of infrastructure for a simple blog!
- Wordpress’ editing and admin interface suck. I prefer vim and bash.
- Markdown is a great language for quickly banging out blog posts.
- Static files just make sense for what is basically static content.
- Github pages provides the hosting for me and even handles CNAMEs for DNS.
- Managing revisions with
The conversion process
It was not an entirely smooth transition, most of which can be traced directly to dumb decisions on my part. I won’t recount the entire process (there are plenty of guides on internets) but I’ll outline the major steps here:
- Export the wordpress blog to an xml file. I has to use
xmllintto clean it up a bit.
- Set up a disqus account and import my wordpress file. Disqus will handle all the comments which are the only dynamic content on the page.
- Use exitwp.py to convert the xml to jekyll markdown files. This worked OK. Not great. Tags and formatting did not come through as expected and I had to wrestle the script a bit. Tables were destroyed and some iframes (youtube links) were lost.
- Forked Jekyll Bootstrap and brought in my posts.
- Started tweaking of css and markdown to get formatting right. Still have a ways to go on this front - let me know if there is any content you’d like me to restore faster than others.
- Had to write a little web service to redirect posts; the old blog stupidly used the default wordpress URLS like
/wordpress/?p=4which needed to go to
- My images were all over the place; some I had in wordpress uploads, others on various servers, some were absolute links, others relative. Gathering them all in one place and using some sed-fu to get the paths right was essential.
- Retagged some posts - still working on tags.
- Set up Google Analytics to track usage.
I think that’s about it. There are still some big formatting problems on older posts (mostly due to the fact that I used blockquotes for code). And tables are still destroyed. I’ll be working on cleaning these up as I go along.
Overall impression of Jekyll-Bootstrap and hosting with Github pages? Awesome. I would highly recomend it to anyone starting a new blog or converting a smaller/better-behaved wordpress site. It is so much better than having to deal with PHP and MySQL (hopefully the last time I’ll ever see them!). But the conversion was a bit tricky and took way more of my Friday and Saturday than I’d like to admit. I would not want to do that again… But I’m glad did.
What do you think of the new digs?
blog comments powered by Disqus