Webmate Sprockets!
Because Sprockets is cool, and Rails is cool, but they shouldn't get married.
Installation
Run
gem install webmate-sprockets
Or add
gem 'webmate-sprockets', require: 'webmate/sprockets'
to your Gemfile
Setup
Webmate Sprockets needs to be configured to work properly. In your server initialization, add a configuration :
Webmate::Sprockets.configure do |config|
config.app = MyApp
['stylesheets', 'javascripts', 'images'].each do |dir|
config.append_path(File.join('app', 'assets', dir))
end
end
The only required field is app
which is necessary to translate app configuration to Sprockets. You will also want to append_paths
as none are included by default. See Configuration for more information.
Include Webmate::Sprockets::Helpers
as helpers in your application :
helpers Webmate::Sprockets::Helpers
And mount the environment :
map '/assets' do
run Webmate::Sprockets.environment
end
Require files in layouts :
<%= javascript_include_tag "application" %>
<%= stylesheet_link_tag "application" %>
image_tag
, favicon_link_tag
, video_tag
and audio_tag
are also provided.
Configuration
Sprockets requires a decent amount of configuration to work properly. Most of the options listed here are taken from the Sprockets/Rails integration. You can get more detailed information in the Rails guide on asset pipelines.
digest
: Boolean value. Should Sprockets use "digest" asset paths? That is, should asset paths be fingerprinted using file digests for cache busting? For more information. This is on by default, though you may want to turn it off in development.
debug
: Boolean value. Should sprockets include assets for debugging? That is, should assets be rendered as individual included files for debugging or as the combination? When on, javascript and stylesheet debugging are much easier. Off by default, though you probably want to turn it on in development.
compile
: Boolean value.
Known Issues
There's no testing or documentation. I know. Want to help?