kotovalexarian-likes-github/rails--rails
1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
Code Releases Activity

Merge pull request #8869 from goshakkk/guides-asset-pipeline-tilt

Browse source 
Add asset pipeline guides section on implementing & registering own engines
This commit is contained in:
Guillermo Iguaran 2013-01-10 11:38:16 -08:00
commit 34126fa6e3
1 changed files with 25 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
guides/source/asset_pipeline.md
View file

@ -720,7 +720,31 @@ A good example of this is the `jquery-rails` gem which comes with Rails as the s
Making Your Library or Gem a Pre-Processor
------------------------------------------
TODO: Registering gems on [Tilt](https://github.com/rtomayko/tilt) enabling Sprockets to find them.
As Sprockets uses [Tilt](https://github.com/rtomayko/tilt) as a generic
interface to different templating engines, your gem should just
implement the Tilt template protocol. Normally, you would subclass
`Tilt::Template` and reimplement `evaluate` method to return final
output. Template source is stored at `@code`. Have a look at
[`Tilt::Template`](https://github.com/rtomayko/tilt/blob/master/lib/tilt/template.rb)
sources to learn more.
```ruby
module BangBang
class Template < ::Tilt::Template
# Adds a "!" to original template.
def evaluate(scope, locals, &block)
"#{@code}!"
end
end
end
```
Now that you have a `Template` class, it's time to associate it with an
extenstion for template files:
```ruby
Sprockets.register_engine '.bang', BangBang::Template
```
Upgrading from Old Versions of Rails
------------------------------------