It has been a while since this website has been updated. Previously I written custom PHP files to iterate over my blog post and display it using markdown to html converter (ParseDown). Maintaining it has become a hassle however, and thus I'm converting the site into Jekyll which is a static site generator (and thus no PHP needed). Of which the biggest advantage for me, is that the output is in simple HTML. Thus it is much more secure than coding a dynamic site to avoid holes that allows for malicious code to enter.

It will take some time to get used to, as well as setting the whole system up.

These are the two links I used to understand how to install jekyll in windows. Unfortunately, it is not as easy to setup in windows compared to linux. This is since you also need to install the windows ruby devkit installer as well standard ruby.

In addition you need to install rogue gem install rouge before inserting highlighter: rouge in _config.yml

  • http://rubyinstaller.org/add-ons/devkit/
  • https://github.com/dmathieu/glynn
  • http://jekyll-windows.juthilo.com/3-syntax-highlighting/

Let me know if you need a step by step script. But the links above should be good enough.

Also, am using a modified version of the rakefiles below here. Very useful stuff:

  • http://stenehall.se/article/write-using-ruby-and-rake---jekyll-again/

Btw here is what my config looks like, hopefully this helps:

# Site settings
title: Brian Khuu
email: mofosyne@gmail.com
description: > # this means to ignore newlines until "baseurl:"
  My name is Brian, I like coding, pixel arts, and electronics!
baseurl: "" # the subpath of your site, e.g. /blog/
url: "http://briankhuu.com" # the base hostname & protocol for your site
twitter_username: mofosyne
github_username:  mofosyne
reddit_username:  mofosyne



# Build settings
highlighter: rouge
permalink: /blog/:categories/:year/:month/:day/:title.html
markdown: redcarpet

By default kramdown is chosen. But since I'm used to github style markdown, I chose to use redcarpet instead (which is also natively supported, so use that too!). Also rouge syntax highlighter is chosen, since the default setting doesn't work for windows.

(Just rememeber to install it via gem install rouge )