Browse files

Edited railties/guides/source/asset_pipeline.textile via GitHub

  • Loading branch information...
1 parent a2cf91a commit a620e65053b1fc613590bee60b4297489f2d35bc @TheEmpty TheEmpty committed Jun 5, 2011
Showing with 15 additions and 3 deletions.
  1. +15 −3 railties/guides/source/asset_pipeline.textile
@@ -20,18 +20,30 @@ The asset pipeline is easy to migrate to and use. There are a few things that yo
h4. Asset Organization
-Loads from /app/assets, /lib/assets, /vendor/assets, and your gem's assets
+Sprockets will automatically load manifest files by searching directories in app/assets and including the first file with a basename of index. (Confirm and add: does it load app/assets/index?)
h4. Directives
-require_tree, require, require_self
+Sprockets, the rails tie that powers the asset pipeline, provides three directives which are like Ruby's methods. They are: +require+, +require_tree+, and +require_self+. These directives must be called at the top of a file in a comment with an equal sign before it. (note: CSS directives need *= if in a continuous comment -- confirm please)
+The require directive loads a file with the supplied basename from the following paths: app/assets/*, lib/assets/*, vendor/assets/*, as well as any of your gem's asset files.
+Require tree does...
+Require self does...
h4. Stacking Preprocessors
-filename.css.scss not filename.scss.css, how and why
+Sprockets allows you to stack preprocessors. The stack is ran off the file extensions in a last in, first out method (like popping an array). For example if we want to make a JavaScript asset with both CoffeeScript and ERB the file would be named: If it were named CoffeeScript would raise an error because it doesn't understand ERB tags.
h4. Adding a Preproccessor
+ for gems or config.register_processor('text/css', MyAwesomeProccessor) for local stuff
h3. Packaging Assets with Your Gems

0 comments on commit a620e65

Please sign in to comment.