Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Generate Html5 Boilerplate for your Rails apps!
tag: v0.0.7

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
lib
test
vendor/assets/javascripts
.gitignore
Gemfile
LICENSE
README.md
Rakefile
html5-rails.gemspec

README.md

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

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

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-2013 Peter Gumeson. See LICENSE for full license.

Something went wrong with that request. Please try again.