Blogging like a hacker with jekyll

  14 Jan 2014


I need something simple that I’ll be able to take some notes somewhere that I can read it later :P, blogging is usually a good place for that since I can re-read what I wrote later as well as I can share my experience to other people for good, I blogged mostly in Thai on blogspot and tried switching to Tumblr (but I’m failed blogging regularly).

And static blog was my obvious solution. Jekyll (a static site generator written in Ruby) was what came into my mind in the first place. But I also wanted to find something similar written in Perl, I found Blio and Riji which both of them are ok to use, though I had to do a bit more work to get a nice layout, a nice theme etc. that seem too much hackery, I just want to blog or just writing content. That meant I wanted more community proven, easier to setup. Later, I found octopress which intended to be Jekyll-on-steroid. It really looks good, I have tried it. Though, its website lacks update, less themes to choose. Therefore, I came back to choose Jekyll for its good community support.

If you’d like to setup and use Jekyll, you should read the quick start guide in Jekyll site. It’s usually the best source to consult with.

Though, the following instruction is how I did for myself. you can follow this as well if you’d like.

Prerequisite

You’ll need to make sure your system has before you start. Ruby and RubyGems on Linux, Unix, or Mac OS X

Setup a blog with jekyll

Super simple, 3 steps:

  1. Run the following command to install Jekyll:

     $ gem install jekyll --no-ri --no-rdoc
    
  2. Now you should have jekyll executable command available to you in your shell (unless, check your $PATH shell variable), then run following command:

    jekyll new your-blog && cd your-blog
    
  3. Start a development server with following command:

    bundle exec jekyll serve --watch
    

That’s it, now browse to http://localhost:4000

And it’s time for you to start creating blog posts, using the front-matter (a valid YAML set between triple-dashed lines) to control templates and layouts.

I use markdown syntax (https://stackedit.io/ and Mou as my main Markdown editor) for blogging which I write them into _posts directory, generated static files in _site.

comments powered by Disqus