README.md in bootstrap-sass-3.0.0.0.rc2 vs README.md in bootstrap-sass-3.0.0.0
- old
+ new
@@ -65,9 +65,38 @@
```css
@import "bootstrap/theme";
```
+The full list of bootstrap variables can be found [here](http://getbootstrap.com/customize/#less-variables). You can override these by simply redefining the variable before the `@import` directive.
+For example:
+```css
+$navbar-default-bg: #312312;
+$light-orange: #ff8c00;
+$navbar-default-color: $light-orange;
+
+@import "bootstrap";
+```
+
+For granular control over what is imported, instead of `@import "bootstrap"`, explicitly specify which modules and components should be included.
+
+Copy `bootstrap.scss` from the gem into the project's vendor/ as `bootstrap-custom.scss`.
+
+```bash
+cp $(bundle show bootstrap-sass)/vendor/assets/stylesheets/bootstrap/bootstrap.scss \
+ vendor/assets/stylesheets/bootstrap-custom.scss
+```
+
+Comment out the import statements you do not need from `bootstrap-custom.scss`.
+
+Finally, in your `application.sass`:
+
+```scss
+ @import 'bootstrap-custom';
+```
+
+NB: This file now needs to be manually kept up to date with structural changes from upstream.
+
### Javascript
We have a helper that includes all Bootstrap javascripts. If you use Rails (or Sprockets separately),
put this in your Javascript manifest (usually in `application.js`) to load the files in the [correct order](/vendor/assets/javascripts/bootstrap.js):