2.1 KiB
Bootstrap for Sass
bootstrap-sass is an Sass-powered version of Bootstrap, ready to drop right into your Sass powered applications.
Installation and Usage
Please see the appropriate guide for your environment of choice:
Development
Upstream Converter
Keeping bootstrap-sass in sync with upstream changes from Bootstrap used to be an error prone and time consuming manual process. With Bootstrap 3 we have introduced a converter that automates this.
Upstream changes to the Bootstrap project can now be pulled in using the convert rake task.
Here's an example run that would pull down the 3.0.0-wip branch from the main twbs/bootstrap repo:
% bundle exec rake 'convert[3.0.0-wip]'
The latest converter script is located here and does the following:
- Converts upstream bootstrap LESS files to its matching SCSS file.
- Copies all upstream JavaScript into
vendor/assets/javascripts/bootstrap - Generates a javascript manifest at
vendor/assets/javascripts/bootstrap.js - Copies all upstream font files into
vendor/assets/fonts
This LESS to SCSS conversion is pretty good, but not perfect. So manual fixes to the resulting SCSS will be necessary for now.
Please submit GitHub issues tagged with conversion to help track current shortcomings of the conversion process.
Credits
bootstrap-sass has a number of major contributors:
- Thomas McDonald
- Tristan Harward
- Peter Gumeson
- Gleb Mazovetskiy