spencern / html5-rails

Html5Boilerplate for Rails using compass-h5bp gem

Html5 for Rails

Html5 for Rails projects based on Html5 Boilerplate by Paul Irish, Divya Manian and many other fine folks.

(Also, a rewrite of compass-html5-boilerplate that adds Rails asset pipeline integration).

Installation

1. In your Gemfile

group :assets do
  gem 'sass-rails'
  gem 'coffee-rails'
  gem 'uglifier'
  gem 'compass-rails'
  gem 'compass-h5bp'
end

gem 'haml-rails' # Optional - to generate haml

gem 'jquery-rails'
gem 'html5-rails'

2. Install your bundle

$ bundle install

3. Run the generator

$ rails generate html5:install

(Here's what it does)

  create  config/compass.rb
  create  config/html5_rails.yml
  create  app/views/layouts/application.html.erb
  create  app/views/application
  create  app/views/application/_footer.html.erb
  create  app/views/application/_head.html.erb
  create  app/views/application/_header.html.erb
  create  app/views/application/_chromeframe.html.erb
  insert  app/assets/javascripts/application.js
    gsub  app/assets/javascripts/application.js
  create  app/assets/javascripts/polyfills.js
  remove  app/assets/stylesheets/application.css
  create  app/assets/stylesheets/_variables.css.scss
  create  app/assets/stylesheets/application.css.scss
  create  app/assets/stylesheets/application
  create  app/assets/stylesheets/application/chromeframe.css.scss
  create  app/assets/stylesheets/application/document.css.scss
  create  app/assets/stylesheets/application/media_queries.css.scss

4. And you're done!

  rails server

Options

To see other generators available run:

$ rails generate html5:layout --help
$ rails generate html5:partial --help
$ rails generate html5:assets --help

Notes

[1] The compass-h5bp gem is not a runtime dependency, but it does need to be included in your assets group for development and asset precompiling to work.

[2] If you use --template-engine=haml (or haml-rails gem), the install generator will remove your application.html.erb layout so that application.html.haml will be used instead.

[3] If you're upgrading from compass-html5-boilerplate you need to remove config/compass.rb before you run the generators.

[4] For the time being, you will want to add the following line to config/production.rb so that polyfills are precompiled on deploy:

config.assets.precompile += %w( polyfills.js )

License

Copyright (c) 2010-2012 Peter Gumeson. See LICENSE for full license.