Bootstrapped¶ ↑
Bootstrapped is a gem that helps you quickly integrate Twitter’s Bootstrap in to your project to enable you to build user interfaces rapidly.
Bootstrapped also contains generators based off of Ryan Bates’s nifty-generators github.com/ryanb/nifty-generators/ to help you rapidly scaffold. Unlike generators nifty-generators.
Setup¶ ↑
Bootstrapped was specifically developed for Rails 3 and above applications. To install, include bootstrapped in your Gemfile.
gem "bootstrapped", :git => 'https://github.com/entropillc/bootstrapped.git'
After running bundle install to install the gem, you need to run the bootstrapped install generator. The generator gives you the ability to install Bootstrapped with Less support or plain CSS. The default is Less support * NOTE: If you are using JRuby, you must use the static version at this time due to compatibility issues with the less.rb gem.
rails g bootstrapped:install [less or static]
To install with Less Support
rails g bootstrapped:install
To install with static CSS Support
rails g bootstrapped:install static
By default, the install generator will include all of the Twitter Bootstrap javascript files in app/assets/javascripts/application.js. If you do not wish to have the javascript files included in your applications.js file, include the –no-javascript option
rails g boostrapped:install --no-javascript
Included Generators¶ ↑
Bootstrapped contains layout and scaffold generators that have been modified to output HTML in Twitter Bootstrap markup. Currently, the following generators are implemented.
-
bootstrapped:layout: generates generic layout, stylesheet, and helper files.
-
bootstrapped:scaffold: generates a controller and optional model/migration.
-
Note suppliying the –haml option to either generator will generate haml templates instead of the dafault erb
The Layout Generator¶ ↑
The layout generator allows you to quickly generate a fixed Twitter Bootstrap layout by running the following command:
rails g bootstrapped:layout OR rails g bootstrapped:layout --haml
You can change the name of the layout by specifying the layout name. For example, the following command will generate a layout called photos
rails g bootstrapped:layout photos
You can also specify if you want a fixed for fluid layout. If you choose to specify the layout, you must specify the layout name as well. The options are fluid and fixed
rails g bootstrapped:layout [layout_name] [fixed or fluid]
An example command:
rails g bootstrapped:layout application fluid
The Scaffold Generator¶ ↑
The layout generator allows you to quickly scaffold applications.
Tests¶ ↑
Bootstrapped has been tested using Cucumber. To run the tests, run the following command
cucumber
Found a bug?¶ ↑
If you are having a problem with Bootstrapped, first look at the FAQs above. If you still cannot resolve it, please submit an issue here.
github.com/entropillc/bootstrapped/issues
Change Log¶ ↑
Version 2.0.3¶ ↑
* Updated Twitter Bootstrap to 2.0.3 * Updated versioning to match Bootstrap for better tracking * Updated version file to contain variable for Bootstrap Version
Version 1.0.1¶ ↑
* Added HAML support in scaffolding * Fixed assets:precompile issue preventing LESS to be compiled for production deployment.
License¶ ↑
Copyright 2011 Entropi Software, LLC.
Licensed under the Apache License, Version 2.0: www.apache.org/licenses/LICENSE-2.0