I’ve recently moved from the rather dynamic Wordpress to the rather static Jekyll. Can you tell?

I’ve come to like the idea of simply serving a bunch of static files instead of dynamically building them when required. Static files are simple, cheap to host and serve, introduce no further security problems beyond the web server and configuration, and easy enough for me, as a developer, to edit.

I’ve still got plenty of hurdles to work through — in particular how to host all my pictures — but this can all be worked out over time one way or another (including reverting back to Wordpress!).

I just wanted to scrawl a few notes about my discoveries — and what better way to do it than within the blog itself!

  • If you run jekyll serve inside of a VM (like Virtualbox) or container (like Docker), if you want to hit the site outside of the VM then make sure to specify --host=0.0.0.0 so the server binds to the outside network interface instead of the loopback interface.

  • I exported the Wordpress data by using the jekyll-export plugin. The script recommended by Jekyll’s own import website produced a bunch of HTML which did not play well with Jekyll.

  • One thing I wanted to do afterwards is convert many of the HTML entities to simpler equivalents, like to ' and and to ". I did this to make my files easily readable and editable, in the spirit of Markdown. A quick way to do this is to run the following:

    for post in _posts/*; do cat "$post" | perl -n -mHTML::Entities -e 'use open ( ":encoding(UTF-8)", ":std" ); print HTML::Entities::decode_entities($_) ;' > $post.new && mv $post.new $post; done
    

    You’ll also need to convert any pages that were brought across too.

    The use open ( ":encoding(UTF-8)", ":std" ); part is of as it instructs perl that all input and output streams are UTF-8.

  • You see that code block nested inside the list above? That cannot be done with Jekyll and Markdown. This is because the {% highlight %} code Jekyll uses is substituted before the markdown is parsed. If you want highlighting, this means you need to use the ~~~ fenced code blocks.

    You could try adding pygments support to Kramdown. Alternatively, you can switch to a renderer, like redcarpet, that does support it. This may well come and bite me in the future.

After all of these changes, my markup (or should I say markdown?) started to look respectable — although there’s a long way to go!