Skip to content

Latest commit

 

History

History
40 lines (20 loc) · 1.16 KB

README.markdown

File metadata and controls

40 lines (20 loc) · 1.16 KB
Raw

Sass Globbing Plugin

Installation

$ gem install sass-globbing

Use with the Sass command line

$ sass -r sass-globbing --watch sass_dir:css_dir

Use with compass

Add the following to your compass configuration:

require 'sass-globbing'

Use with Ruby on Rails

Ruby on Rails has this capability out of the box starting in Rails 3.1. Do not install this plugin if you use Rails 3.1 or greater.

Stylesheet Syntax

Import a folder of files:

@import "library/mixins/*"

Import a tree of files:

@import "library/**/*"

Globbed files are sorted alphabetically before importing them.

Globs are always relative to the current file. The ruby glob file syntax is used, read the docs for more that you can do with it.

Caveats

CSS is order dependent, as such, using this approach within your stylesheets to import styles that depend on the stylesheet's cascade creates an opportunity for styles to change more unpredictably than a manually asserted order. It is recommended that you only use globbing where order is unimportant; E.g. importing of library files.