jekyll_ext

jekyll_ext allows you to extend the Jekyll static blog generator without forking and modifying it’s codebase.
With this code, not only do your extensions live in your blog directory, but they can also be shared and reutilized.

More information can be found here: Jekyll Extensions -= Pain

Installation

(This was extracted from the blog post Jekyll Extensions -= Pain)

1. Grab the jekyll_ext code from GitHub:
   git clone git://github.com/rfelix/jekyll_ext.git
2. Locate the lib directory in the Jekyll gem installation.
   which jekyll should give you the path to the executable.
   In my case, it displayed /Users/rfelix/.gem/ruby/1.8/bin/jekyll, therefore the lib directory is located at /Users/rfelix/.gem/ruby/1.8/gems/jekyll-0.5.7/lib/
3. Open up the jekyll file in the jekyll_ext directory and edit the constants JEKYLL_LIB and JEKYLL_EXT to contain the paths to the Jekyll gem lib dir and the jekyll_ext dir, respectively.
4. Now you have two options:
   • symlink the jekyll script to a path in your PATH environment, but make sure that the path is consulted before the Ruby gems path. You can confirm the right jekyll is being used by issuing jekyll --version which should give you: Jekyll (extended) 0.5.7
   • Or, replace the jekyll file in the Ruby gems directory (that you obtained from step 2) with a symlink to the file in jekyll_ext/jekyll.

Now you just need to create the directory extensions/ in your blog and create the file _extensions/jekyllext.rb which should load all the extensions that your blog uses.

You can use my own extensions to help you get started: my_jekyll_extensions