No commit activity in last 3 years
No release in over 3 years
Use Sprockets effectively with Webmate.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 2.10
 Project Readme

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?