Jekyll Newbie Guide

Published: 09 Jan 2011

A Newbie(like me) Guide for Jekyll

Tools(for Mac)

  • Vim + tpope’s vim-markdown + csexton’s jekyll.vim + tpope’s vim-fugitive

    Vim is, needless to say, an editor. I recommend plugins mentioned above for writing and version controlling(you should always do that) your posts.

  • Visor

    You need to be familiar with Terminal in order to use Jekyll. I’m a GUI guy as much as you are so Visor make my life a little easier. Visor is a system-wide terminal on a hot key. When you press your hotkey, Terminal wrapped with Visor drops down. It looks cool enough to use it more often so you can learn commands(well, you’ll only need cd to move around directory and jekyll to build sites).

Websites Get You Started on Jekyll

Recommend Plugins for Jekyll

Jekyll can be extended its capability via plugins. Here I’m not gonna try to collect all plugins available, but I’ll list ones I use or I’ll try to use.

Currently Using

  • tatey’s jekyll_plugins

    I use LESS CSS converter and JavaScript Minifier. I couldn’t figure out how to use growl one, but I’d like to try it again.

  • indirect’s jekyll_postfiles

    A plugin adds files for each post. You can add files on post basic. You need to create a directory named after the post in _postfiles, then you can refer to the file using /2011/01/09/jekyll-newbie-guide/YOURFILENAME.EXTENSION . I need this to show screen shots of my theme.

Will Look into