Theme For Rails (3 and hopefully later)

Features list

• Support for adding themes which includes stylesheets, javascripts, views and layouts.
• add a theme-image-url sass helper method for asset pipeline based themes
• update the generators and rake tasks to support asset pipeline based themes
• (NEW) works with the Rails Assets Pipeline without interfering, and leveraging it.

Compatibility

This gem works with Rails from version 3.0 to at least 3.2.1 (current at the moment of writing this readme file).

Documentation

• Rdoc
• Wiki
• Old Readme File

Ideas / Inspiration

• Add ThemesForRails::Railtie for configuration, so we selectively set the plugin on or off. Also to be able to change several settings.
• Add routes to allow access to the theme’s static resources (js and cs), unless cached on public folder by capistrano / rake.
• Extend Action View path in order to make the views accessible. Same for the layouts.
• More tests ford edge cases. Now I am only testing the happy paths.

Rails 2 Support

This gem only works with Rails 3 (duh). If you want the same exactly behavior, but for Rails 2.x, go here .

Rails 3 Asset Pipeline

Follow the Split Theme Storage describe here: https://github.com/lucasefe/themes_for_rails/wiki/Assets-Pipeline-Integration

On config/application.rb:

ThemesForRails.available_themes.each do |theme_dir|

  config.assets.paths << theme_dir

end

On config/production.rb:

config.assets.precompile += [‘[theme]/stylesheets/theme.css’] # Precompile asset themes

config.assets.digest_themes_for_rails = true # Enable digest on Themes for Rails assets

Running tests

gem install bundler
bundle install
rake

Authors and contributors

• lucasefe
• jedifreeman
• jbarreneche
• kule
• matheusmoreira
• rafaelss
• maxjgon

Last but not least

If you are using this gem, please, take a minute to recommend me at Working With Rails.