Introduction: Why I needed a blog

As you can read in my About page, I run into ‘tech adventures’ all the time. I ran into plenty of them, but I never documented anything. I would fix the problem, maybe tell some friends, end of story. And that was a real shame actually. I’m sure that posting some of the stuff I ran into would have helped other people. When I got my own domain a few days ago, I decided things needed to change. I would start my own blog!

But which blog should I use?

This was a hard question for me. Wordpress seemed like an obvious choice, since just about everybody uses it and it shouldn’t be too hard too install. A large userbase also offers advantages in the form of good community documentation and regular updates and fixes. But I was worried about how many resources Wordpress would need. I just wanted a simple blog and running Wordpress would probably be overkill. I considered just making HTML pages manually, but maintaining it would probably become a pain in the ass. I needed something simple, lightweight and secure.

That’s when I found Jekyll. Exactly what I was looking for! Jekyll transforms plaintext posts into a blog using only static HTML pages. It doesn’t get much more simple, lightweight or secure than static HTML pages!

Installing Jekyll on Debian Jessie (and Wheezy and Sid)

Normally, I wouldn’t write about something as trivial as this, but there is quite a number of tutorials online which recommend you install ruby and then install Jekyll using the command gem install jekyll. This works, but it is better to use apt-get install jekyll instead.

Using Jekyll

Using Jekyll is pretty simple. With the command jekyll new <name> jekkyl automatically creates a new project in the directory. After that, you can start writing posts with your favourite text-editor using markdown (or whatever) and place them into the posts folder. Since I already had Apache installed as webserver, all that was left for me to do was to generate the HTML pages using jekyll build -d /var/www/html. Warning: this deletes all content in the folder /var/www/html!

And that’s it folks!