My articles about Jekyll

The way to have two or more Jekyll blogs in your Git Pages website

I wanted to split my blog into two separate blogs, one for my technology articles and one for everyday tips and tricks, so I searched for a way to do that on my Jekyll website which is hosted on a Git Page on GitHub.

Unfortunately Git Pages do not support the version 2.0 of the jekyll paginate plugin which would allow me to split the posts into Categories and iterate on each blog over a specific category.

Here are the steps I followed to solve this problem:

Read the complete article

The complete guide on how to update your Jekyll blog to the latest version on your Windows machine

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.

Read the complete article

How to speed up the compilation of your Jekyll website when you use npm modules

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.

Read the complete article

A quick guide about how to transfer your Jekyll blog from GitHub to Bitbucket and host it with Aerobatic for free!

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:

Read the complete article

How to fix the "Invalid tag value. This XML tag has an invalid value. Please fix it and resubmit." error when using the jekyll-sitemap gem.

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.

Read the complete article

How to deactivate Ruby code from executing when it is used inside a code example highlighted with pygments

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.

Read the complete article

Use Jekyll and Bootstrap to create a tag-area with links to pages showing only the articles of the current tag

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:

<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>
    {% endfor %}
Read the complete article

Six simple steps to install the pygment syntax highlighter in a Jekyll blog that uses bootstrap.

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.

Read the complete article