I assumed that, when I migrated from Wordpress to Jekyll, one of the casualties would be the old Wordpress comments. I had decided to use DISQUS for comments on Jekyll, partly because it is the “new thing” and partly because it is incredibly easy to achieve. But I never for a moment considered that migrating the old comments would be a possibility.

In fact, not only is it possible, but it is almost trivially easy.

I did encounter a few issues, as I had foolishly renamed some pages to more logical names, thereby both breaking all Google and other links, but also breaking the link with DISCUS comments. That was a very bad idea and as a consequence I spent quite a while renaming files back again, but other than that it all worked flawlessly. If you are going to rename pages - probably best to do it in Wordpress before migrating to Jekyll.

Well done [DISCUS] for making something that you would expect to be difficult easy. And thank you Wordpress for providing a decent export routine, without which my data would have been locked away.

I look forward to your comments!

Chris.

Following my recent announcement, I thought I would give some of my reasons for the move and some early impressions of using Jekyll.

What is Jekyll?

Jekyll is a Markdown based website and blogging platform, written in Ruby. The principle is simple - you write markown text files and they are automatically converted to static HTML webpages.

What is Markdown?

I am assuming that most of my audience have at least a passing knowledge of Markdown, but basically it is a very clean virtually syntax-free way of writing text files, so that they can be easily converted into different formats. The key to markdown is the conversion utility and I currently use Pandoc. I write the file once, and then I can convert into whatever format I want it in:

• PDF: pandoc -o sample.pdf sample.markdown
• Word: pandoc -o sample.docx sample.markdown
• HTML: pandoc -o sample.html sample.markdown

I would imagine most people start using Markdown so that can continue to use the favourite text editor - Vim or Emacs. At work I have found myself using it in preference to a word-processor, I have written a simple md2pdf perl script, so that in vim I can simply type :md2pdf % to have my document saved as a PDF. And the PDFs that Pandoc produces are beautiful and headings and sub-headings are automatically converted into PDF Bookmarks, giving your documents an effortless professionalism.

For complicated documents I sometimes start in Markdown and then move to LaTeX, but increasingly I am finding myself able to do virtually everything in Markdown, including simple images and hyperlinks. But you also have the option of extending plain markdown with HTML tags.

So in simplest terms Jekyll is just an automated way of creating Markdown files and converting them to HTML.

But why change from Wordpress?

Wordpress has been great for me, it’s relatively simple, has great statistical tools, a build in commenting system and much more besides. So why leave all that behind for something which is fundamentally so basic?

Benefits of Jekyll

1. Text Editor: Once again the desire to use Vim was probably the key motivation.
2. Github Pages: The fact that Jekyll could be used with the free Github Pages was another.
3. Command Line: The ability to use grep, sed and perl and all the other command line goodies makes for an incredibly versatile system.
4. Version Control: To have the whole site under version control.

I cannot tell you how wonderful it is to grep -l searchtext *.markdown | vim - and be able to edit each matching file in Vim.

Bootpolish Blog

There was another reason too, which was that I still had an old blog at bootpolish.net, which I wanted to close down. I could have merged it into my Wordpress blog, but I thought it would be easier to transfer it to Jekyll. To be honest I can’t say that it was particularly easy, but thankfully it is now done.

The Migration Process

I followed the GitHub Instructions for Jekyll. I used rsync to copy the underlying text files from Bootpolish.net into the _drafts folder, before using bash for loops to auto-process each into a Jekyll markdown post. I used the Wordpress Importer to transfer my Wordpress blog. The importer did not work particularly well, so I ended up editing each file in turn.

I found there was some customisation required:

1. Categories: By default Jekyll has no Category pages, for example: http://chrisjrob.com/category/technology/
2. Tags: By default Jekyll has no Tag pages, for example: http://chrisjrob.com/tag/3dmodel/
3. Wordpress RSS: I wanted to maintain the existing feed locations, which required creation of various additional feeds.
4. Tag Cloud: By default Jekyll has no tag cloud functionality, which I believe is crucial to a blog.
5. Site Search: By default Jekyll has no site search. There are plug-ins, but these are not compatible with GitHub pages. For now I have used Google Custom Search, but it has not yet indexed the entire site.

I have written a script to build all the tags and categories, which is working well. I would like to integrate this into the git commit command somehow, so that I don’t forget to run it!

Any new categories would require additional RSS feed files creating, by simply copying the feed template into the relevant category/feed folder.

Conclusions

This has been much more work than I would have liked. That said, I now have my Markdown files in a format under my control. I can move those files to any Jekyll provider, or indeed to any web provider and have them hosted.

In short, I am hoping that this is the last time I will move platforms!

Lastly, if you’re unfamiliar with Markdown, you can view the Markdown version of this page.

For the past few weeks I have migrating chrisjrob.com from Wordpress to Jekyll. I have also been merging in my previous blog at bootpolish.net.

This process has proved to be much more work than I expected, but this evening it all came together and I finally pressed the button to transfer the DNS over to the Jekyll site, hosted by GitHub.

I have tried to maintain the URL structure, along with tags, categories and RSS feeds, but it can’t be perfect and there will be breakage.

If you notice any problems please do comment below.

Thank you.

Chris Roberts

http://chrisjrob.com/

The old chrisjrob.wordpress.com will continue to work, but will redirect to chrisjrob.com. At least until the day I decide to leave Wordpress whereon I will disappear into oblivion.

Actually, I am very happy with Wordpress.com, so am unlikely to be leaving any time soon.

What I have decided is to cut down on the number of categories and treat these as “feeds”; so I have a technology feed, a Linux feed, a Debian feed, and only a couple of others. These are the feeds to which I am committing to maintain, so if you are only interested in my posts on Linux, you can feel confident about changing your subscription to my Linux category.

The remaining categories are:

• http://chrisjrob.com/category/personal/
• http://chrisjrob.com/category/technology/
• http://chrisjrob.com/category/technology/linux/
• http://chrisjrob.com/category/technology/linux/debian/
• http://chrisjrob.com/category/technology/linux/ltsp/

As you can see from the above layout, my technology feed will include Linux and Debian.

For the RSS feeds, just append “feed/” to the end of the above categories, or visit the above pages and subscribe to the feeds via your browser feed functionality.

This means that you can subscribe to the element of my blog that you find interesting, and save yourself the grief of reading about my dog waking me up at 5.00am vomiting. Or, if you are one of my non-geek friends, you could subscribe to my personal feed and avoid all my weird ramblings about the leenucks.

If you want a more fine-grained approach, then you can of course use the tags in the same way, but the difference is that I am not committing to maintain tags, the tags are by their nature more anarchic. But nevertheless if you wanted to watch my posts on the dreamplug (random example) you would just visit:

• Web: http://chrisjrob.com/tag/dreamplug/
• Feed: http://chrisjrob.com/tag/dreamplug/feed/

Just don’t be surprised if there are no further posts on dreamplug. There probably won’t be.

Be warned, part of the reason for this change is that I intend starting a more personal blog, which could be exceedingly boring for some of you; just subscribe to the technology or Linux feeds instead.

I wanted to change my blog so that the home page only has an opening paragraph of each blog post, rather than having the full text.  In my opinion this makes the blog easier and more pleasant to navigate.  Unfortunately it seems that in trying to achieve this, I changed the RSS feed as well.

My apologies for this error, it wasn’t deliberate and I do appreciate that it is more convenient to read the whole text from within your chosen RSS aggregator.  Although it was nice having the additional page views - twice as many today as yesterday…

I think I have corrected the problem, so we should be back to full text for this and all subsequent posts.  If not, let me know!