0_instructions.txt

Some brief instructions on how to use Sprocket 2 in Rails to get CoffeeScript
powered JS and SASS powered CSS with YUI compression all via the magic of rack.

This stuff will be native in Rails 3.1 and the layout of the files on the
filesystem will be different but this guide will get you working with it
while we wait for all that to finalize.

Ignore the number prefixes on each file. This is just to ensure proper order in the Gist.

It's based on eric1234 gist https://gist.github.com/911003. ijust made it 3.1 compliant in terms of convention

1_Gemfile.rb

gem 'coffee-script'
gem 'yui-compressor', :require => 'yui/compressor'
gem 'sass'
gem 'json' # sprocket dependency for Ruby 1.8 only
gem 'sprockets', :git => 'git://github.com/sstephenson/sprockets.git'

# Sprockets needs to build JS file. On mac it uses apple java compiler, on production server (linux for example) you need to 
# install this gem
group :production do
  gem "therubyracer"
end

2_asset_server.rb

# Config a Sprockets::Environment to mount as a Rack end-point. I like to use a subclass
# as it allows the config to be easily reusable. Since I use the same instance for
# all mount points I make it a singleton class. I just add this as an initializer to my
# project since it is really just configuration.
class AssetServer < Sprockets::Environment
  include Singleton

  def initialize
    super Rails.root.join('app', 'assets')
    paths << 'javascripts' << 'stylesheets'
    if Rails.env.production?
      self.js_compressor = YUI::JavaScriptCompressor.new :munge => true, :optimize => true
      self.css_compressor = YUI::CssCompressor.new
    end
  end

end

3_routes.rb

# Mount the rack end-point for JavaScript and CSS.
MyApp::Application.routes.draw do
  # Add this line 
  mount AssetServer.instance => '/assets'
end

4_application.js

# Put this in your assets/javascripts/application.js directory and call /assets/application.js in your browser
# You need to have jquery and jquery_ujs files (jquery_ujs is sometimes named rails.js)
#
# In your layout just add
#
#   <%= javascript_include_tag "/assets/application" %>
#
# In Rails 3.1 you could even do
#
#  <%= javascript_include_tag "application" %>
#
//= require jquery
//= require jquery_ujs
//= require_tree .

5_your_file.js.coffee

# Put this in your app/assets/javascripts directory, it will be included when you call /assets/application.js in your browser
alert 'hello world'

7_application.css

// Put this in your app/assets/stylesheets directory and call /assets/application.css in your browser
// In your layout just add
//
//   <%= stylesheet_link_tag "/assets/application" %>
//
// In Rails 3.1 you could even do
//
//  <%= stylesheet_link_tag "application" %>
//

/*
 *= require_tree . 
*/

7_your_file.css.scss

// Put this in your app/assets/stylesheets directory and call /assets/application.css in your browser
body {margin: 2px + 5px}

8_conclusion.txt

Sprockets 2 has a lot more under the hood but this gets you started.
A few things not covered:

1. Anything supported by Tilt can be used as a template engine
   (not just Sass and CoffeeScript).
2. Although Sass has native abilities to include other files, Sprockets 2
   gives the ability to all formats through special comments like:
     // =require "foo"
   It's special commands can be fairly powerful (like requiring an entire
   directory or tree). NOTE: Use the comment character relevant for the
   language. So coffescript should be:
     # =require 'foo.js'
   Then you can create 'foo.js.coffee' and when served it will be as one
   file.
3. Sprockets 2 has the ability to pre-compile the assets for maximum speed.
   Also useful when the deployment environment doesn't support a template
   language (like CoffeeScript).

Having trouble getting javascript_include_tag to work with this setup. I have a rails 3.0.5 app, and am trying to config 3.1-style assets. I've bundled the gems above, added AssetServer to the initializers and verified that it's being loaded, mounted AssetServer in routes.rb, and then called stylesheet_link_tag "/assets/application" from my layout template.

Keep getting routing errors saying application.js can't be found. Am I overlooking something, or doing something stupid? Or has sprockets 2 changed? It seem like a moving target.

Pulling my hair out, any help hugely appreciated.

Sprockets has changed, more precisely the paths moved from Environment to another class. Unfortunately this doesn't help me to fix the configuration...

Looks the paths are added with append_path('javascripts'); append_path('stylesheets'), which comes from the module Trail:

http://rdoc.info/github/sstephenson/sprockets/master/Sprockets/Trail

Still not working for me tho :-/

With latest beta11, the append_path did the trick for me.

Omg, this was exactly what I needed. Thanks!

https://gist.github.com/1112393 (I've made some changes to fit my needs)
I'm asking a question in this gist, if anyone can help me on this, it'd be great :)