jekyll-sass 0 ruby Rubygems

Sass CSS converter for Jekyll based on jekyll-less

Sass for Jekyll

This gem provides a Jekyll converter for Sass files.

Basic Setup

Install the gem:

[sudo] gem install jekyll-sass

With Jekyll 2, simply add the gem to your _config.yml gems list:

gems: [jekyll-sass]

Or for previous versions, create a plugin file within your Jekyll project’s _plugins directory:

# _plugins/my-plugin.rb
require "jekyll-sass"

Place .scss files anywhere in your Jekyll project’s directory. These will be converted to .css files with the same directory path and filename. For example, if you create an scss file at css/my-stuff/styles.scss, then the corresponding css file would end up at css/my-stuff/styles.css.

Bundler Setup

Using bundler to manage gems for your Jekyll project? Just add

gem "jekyll-sass"

to your gemfile and create the following plugin in your projects _plugins directory. This will automatically require all of the gems specified in your Gemfile.

# _plugins/bundler.rb
require "rubygems"
require "bundler/setup"
Bundler.require(:default)

Configuration

In your _config.yml

# defaults
sass:
	style:  expanded  # nested|expanded|compact|compressed
	deploy_style: compressed  # nested|expanded|compact|compressed
	# "deploy_style:" is used only for building the site
	# (ie: not using the --watch flag)

	compile_in_place: false   # true|false
	# If true, compiles sass directly into your jekyll source directory
	# As well as your destination directory

Credit

This gem is based on @zroger’s jekyll-less, with contributions from @zznq, @Tambling, @rebelzach, @kelvinst, and @bitboxer.

Related Repositories

jekyll-gulp-sass-browser-sync

jekyll-gulp-sass-browser-sync

A starter project including full setup for Jekyll, GulpJS, SASS & BrowserSync ...

jekyll-foundation

jekyll-foundation

Start your Jekyll (v3) project with Zurb Foundation for Sites (v6, sass). ...

jekyll-example

jekyll-example

Example Jekyll site with basic defaults and Sass enabled. ...

jekyll-sass

jekyll-sass

Sass CSS converter for Jekyll based on jekyll-less ...

muffin

muffin

A design focused front-end web development template using SASS and Jekyll. ...


Top Contributors

noct rebelzach zroger tambling bitboxer kelvinst randallb euler0 zznq

Releases

-   1.2.2 zip tar
-   1.2.1 zip tar
-   1.2.0 zip tar
-   1.1.0 zip tar
-   1.0.0 zip tar