I lately had to install Jekyll on my new machine for some local development and realized that I should also update the Jekyll version of my blog. With this guide I am going to show you the steps for updating your Jekyll blog and how to fix a number of possible errors, if your blog or its dependencies are outdated.

Chances are high that you are going to use plugins from npm in your Jekyll website. For example you might want to minify the CSS files by using Gulp, or bundle together your JavaScript files with Webpack.

A new node_modules folder is going to be created on the root of your website and now all of a sudden your website need much more time to be build when you start the development-server with Jekyll serve.

Recently I decided to transfer my personal blog which is implemented with Jekyll from GitHub to Bitbucket and access it with the Aerobatic addon.

Here is a compact list of steps you have to follow if you also want to host your Jekyll blog on Bitbucket:

After I installed the jekyll-sitemap gem on my Jekyll website and tried to register the generated sitemap in my Google webmaster account, I received from Google the following error:

Invalid tag value. This XML tag has an invalid value. Please fix it and resubmit.

When you want to highlight ruby-code snippets you will deal with the problem that the code, even when it is wrapped inside the {% highlight ruby linenos %}…{% endhighlight %} tags, it gets executed and you do not see the code snippet itself.

For my personal blog, which in based on Jekyll, I created a tag-area on the top of the homepage so that the visitors are able to navigate through the different articles in a tag-page by clicking on the tag that they are interested in. With this article I would like to present you the code of the tag-area:

1
2
3
4
5
6
7
<div class="well well-sm">Filter the articles:
    {% for tag in site.tags %}
        <a class="btn btn-warning" type="button" href="tags/{{ site.baseurl }}{{tag | first }}">
            {{ tag | first }} <span class="badge">{{ tag | last | size }}</span>
        </a>
    {% endfor %}
</div>

Highlighting your code-examples in your blog makes your articles simpler to read. When using Jekyll the “default” option for highlighting code is provided from the pygments plugin.