A nanoc filter to use Sprockets, a Ruby library for compiling and serving web assets.
Ruby
Permalink
Failed to load latest commit information.
lib
.gitignore
CHANGELOG.md
Gemfile
LICENSE
README.md
Rakefile
nanoc-sprockets-filter.gemspec

README.md

Nanoc::Sprockets::Filter

A nanoc filter to use Sprockets, a Ruby library for compiling and serving web assets.

Installation

Add this line to your application's Gemfile:

gem 'nanoc-sprockets-filter'

And then execute:

$ bundle

Or install it yourself as:

$ gem install nanoc-sprockets-filter

Usage

We recommend installing the sprockets-sass and sprockets-helpers gems for better integration. Also, use the uglifier gem to minify javascripts. All these dependencies are optional and you can use any other compressor supported by Sprockets.

Require dependencies and configure Sprockets helpers to generate assets with digest.

require 'sass'
require 'uglifier'
require 'sprockets-sass'
require 'nanoc-sprockets-filter'

Nanoc::Helpers::Sprockets.configure do |config|
  config.environment = Nanoc::Filters::Sprockets.environment
  config.prefix      = '/assets'
  config.digest      = true
end

Add compile rule for stylesheets and javascripts, css_compressorand js_compressor is optionnal and value can be replaced by any compressor supported by Sprockets. Add route rule for all assets and use sprockets-helpers to generate file path.

compile %r{/assets/(stylesheets|javascripts)/.+/} do
  filter :sprockets, {
    :css_compressor => :scss,
    :js_compressor  => :uglifier
  }
end

route '/assets/*/' do
  Nanoc::Helpers::Sprockets.asset_path(item)
end

You can use nanoc-gzip-filter to create a gzipped version of stylesheets and javascripts files.

compile %r{/assets/(stylesheets|javascripts)/.+/} do
  filter :sprockets, {
    :css_compressor => :scss,
    :js_compressor  => :uglifier
  }
  snapshot :text
  filter :gzip
end

route '/assets/*/', :snapshot => :text do
  Nanoc::Helpers::Sprockets.asset_path(item)
end

route '/assets/*/' do
  Nanoc::Helpers::Sprockets.asset_path(item) + '.gz'
end

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request