diff options
| author | Mohammad Typaldos <mohammad.elabid@gmail.com> | 2011-06-05 14:49:50 -0700 |
|---|---|---|
| committer | Mohammad Typaldos <mohammad.elabid@gmail.com> | 2011-06-05 14:49:50 -0700 |
| commit | a620e65053b1fc613590bee60b4297489f2d35bc (patch) | |
| tree | 2310122a272b0e24329309506a53e7a7d6e433b6 /railties/guides | |
| parent | a2cf91a1a4382869aaff7d7b0fbbb60336a3c830 (diff) | |
| download | rails-a620e65053b1fc613590bee60b4297489f2d35bc.tar.gz rails-a620e65053b1fc613590bee60b4297489f2d35bc.tar.bz2 rails-a620e65053b1fc613590bee60b4297489f2d35bc.zip | |
Edited railties/guides/source/asset_pipeline.textile via GitHub
Diffstat (limited to 'railties/guides')
| -rw-r--r-- | railties/guides/source/asset_pipeline.textile | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/railties/guides/source/asset_pipeline.textile b/railties/guides/source/asset_pipeline.textile index 7ebc10b384..5d0dfee41c 100644 --- a/railties/guides/source/asset_pipeline.textile +++ b/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 +WIP + +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 +WIP + +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: +name.js.coffee.erb+. If it were named +name.js.erb.coffee+ CoffeeScript would raise an error because it doesn't understand ERB tags. h4. Adding a Preproccessor +WIP + https://github.com/rtomayko/tilt for gems or config.register_processor('text/css', MyAwesomeProccessor) for local stuff h3. Packaging Assets with Your Gems |