A gem that adds slim-lang support to Jekyll.
Ruby
Pull request Compare This branch is 33 commits ahead of sunnyrjuneja:master.
Latest commit ce6a731 Oct 10, 2014 @minad minad update readme
Permalink
Failed to load latest commit information.
lib fix require Aug 5, 2014
.gitignore Initial commit Apr 7, 2013
.rspec Version bump to 0.8.0 Apr 13, 2013
.travis.yml Add Travis image badge Apr 13, 2013
Gemfile Initial commit Apr 7, 2013
History.md v0.10.0 Oct 9, 2014
LICENSE.txt v0.10.0 Oct 9, 2014
README.md update readme Oct 10, 2014
jekyll-slim.gemspec v0.10.0 Oct 9, 2014

README.md

Jekyll-slim

Gem Version Dependency
Status Code
Climate Build Status

A gem that adds slim-lang support to Jekyll. Works for for pages, includes and layouts.

Installation

Add this line to your Gemfile:

gem 'jekyll-slim'
gem 'slim', github: 'slim-template/slim'

And then execute:

$ bundle

Or install it yourself as:

$ gem install jekyll-slim

In your Jekyll project's _plugins directory:

# _plugins/jekyll-slim.rb
require 'jekyll-slim'

Important!

This gem requires slim from the github master branch for now.

Usage

The gem will convert all the .slim files in your project's directory into HTML. That includes files in sub-directories, includes and layouts. Example:

# _layouts/default.slim
html
  head
  body
    .content-wrapper {{ content }}

To include a partial, use the slim liquid tag instead of include:

# index.slim
---
layout: default
---

section.content Content goes here.
% include footer.slim

Options

Is possible to set options available for Slim engine through the slim key in _config.yml. Example:

# _config.yml
slim:
  pretty: true
  format: html5

Context

The slim context is set to acess a SlimContext object which has a site method, used to access config. Be careful because this is a breaking change.

This allows you to access configuration information in your slim file. Example:

html
  head
  body
    .content-wrapper
      = "slim pretty mode: #{ site.config['slim']['pretty'].to_s }"

The SlimContext object will be kept across calls, allowing you to easily set @instance_variables that can be accessed by all slim files even those included with the slim liquid tag. Those are more or less global variables in slim templates, so be careful when you use them.

Looking for maintainers

We are looking for maintainers for this gem.

Credit

Jekyll-slim was heavily inspired by jekyll-haml. It is free software, and may be redistributed under the terms specified in the LICENSE file.