Contents

# 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][globbing_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.


[globbing_docs]: http://ruby-doc.org/core/classes/Dir.html#M000629

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
sass-globbing-1.0.0	README.markdown
sass-globbing-1.0.0.rc.2	README.markdown
sass-globbing-1.0.0.rc.1	README.markdown