Sass Rails Bootstrap
Bootstrap is Twitter's toolkit for kickstarting CSS for websites, apps, and more. It includes base CSS styles for typography, forms, buttons, tables, grids, navigation, alerts, and more.
To get started -- checkout http://twitter.github.com/bootstrap!
This gem provides the version of the toolkit with LESS stylesheets converted into SASS for use in Rails 3.1+ projects.
Installation
This library requires the sass-rails gem to work, and will pull this in at installation.
Include the following line in your Gemfile and you're all set:
gem 'sass-rails-bootstrap'
Usage
Stylesheets
The easiest way to use Bootstrap stylesheets is to import "twitter/bootstrap"
in your application.css.sass
file:
@import "twitter/bootstrap"
Alternatively, you can import each file individually, which allows for some customization.
You'll be able to replace some of the imported files with your own (variables.css.sass
would be a good candidate for this), or include just a selected few files for you to use.
Let's say that you want to use just the variables and mixins that come with Twitter Bootstrap.
You can accomplish this by including the following lines in your .css.sass
file:
@import "twitter/bootstrap/variables"
@import "twitter/bootstrap/mixins"
As per the Bootstrap project, twitter/bootstrap
doesn't include the responsive styles.
You'd have to import the file manually to get them:
@import "twitter/bootstrap-responsive"
Javascripts
As with the stylesheets, you have two options. You can include all of the scripts with a single directive
that goes into your application.js
file:
//= require twitter/bootstrap
Alternatively, you could include only the files you need:
//= require twitter/bootstrap/alert
//= require twitter/bootstrap/button
//= require twitter/bootstrap/scrollspy
Versioning
This gem will directly track the semantic versioning releases of the Twitter Bootstrap project. Our major and minor versions will always match to theirs.
Currently, this gem reflects the Bootstrap version 2.2.2 up to the commit: https://github.com/twitter/bootstrap/commit/9f29785783e58a7ffc6f8779c2ae55edebd54ba2
Copyright and license
Twitter Bootstrap Project: http://twitter.github.com/bootstrap
Copyright 2012 Twitter, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.