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_compressor
and
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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request