Home / All Plugins

Available Plugins (52)


Top Contributors

Most Forked

Most Watched

Most Starred

Grok is a full stack web shop with engineers specializing in Ruby, Rails, PHP, javascript, databases, and general software architecture based in San Antonio, Texas.

We grok the web!

Plugin Information

jade-jekyll-plugin

Converter Plugin that brings Jade support to the Jekyll blog-aware, static site generator


README.md

jade-jekyll-plugin

Converter Plugin that brings Jade support to the Jekyll blog-aware, static site generator.

HOWTO

  1. Install Jade with NPM. e.g. $ npm install jade -g
  2. Place the jade.rb file into your Jekyll installation under _plugins/
  3. All static pages and posts ending in the extension .jade are now processed through Jade automatically.
  4. Layouts need special treatment, see below.

Applying Jade to Layouts

Unfortunately Jekyll doesn't yet allow plugins to pre-process layout files before further processing. To write your layouts in Jade, you therefore have to render them externally. Fortunately this only needs to be done frequently for a small period of time, during layout development.

During layout development, we recommend:

  1. Create a _layouts/jade/ folder where you will place your "pre-rendered" Jade source.
  2. Create a Makefile or shell script to execute the Jade compile-and-watch command: jade -w -o ../ *.jade
  3. In another terminal, simultaneously run your Jekyll builds: e.g. jekyll serve -w

See Also

Read the companion blog post, Templating your Jekyll Blog with Jade.

License

See LICENSE.