kotovalexarian-likes-github
/
twbs--bootstrap-sass
mirror of https://github.com/twbs/bootstrap-sass.git
1
0
Fork 0
Code Releases Activity
Official Sass port of Bootstrap 2 and 3.
281 Commits 10 Branches 63 Tags 15 MiB
SCSS 54.7%
JavaScript 20%
Ruby 16.9%
Sass 7.5%
Slim 0.7%
Go to file
Peter Gumeson e6e0cd2bad Moved converter instructions into readme 2013-05-30 00:25:02 -07:00
lib make it work 2013-05-02 14:34:25 +02:00
tasks Remove unused gradient mixin replacement 2013-05-28 23:41:20 -07:00
templates/project Update javascripts in compass manifest 2013-05-24 17:48:08 -07:00
test Merge branch 'master' into 3 2013-04-13 16:16:40 +01:00
vendor/assets Merge branch '3' of github.com:intridea/bootstrap-sass into 3.0.0-wip 2013-05-29 23:41:22 -07:00
.gitignore Added bundler dirs to gitignore. 2013-05-23 14:48:27 -07:00
.travis.yml Ah, finally got the travis config. Updated for gem version bump. 2012-11-01 09:59:36 -04:00
CHANGELOG.md bring Changelog up to date 2013-04-13 16:32:50 +02:00
CONTRIBUTING.md Moved converter instructions into readme 2013-05-30 00:25:02 -07:00
Gemfile Add bundler for easy install of gem dependencies 2012-09-01 17:06:54 +01:00
LICENSE Extracted Bootstrap from QA 2011-09-06 20:08:31 +01:00
README.md Moved converter instructions into readme 2013-05-30 00:25:02 -07:00
Rakefile Ported converter rake task from compass-twitter-bootstrap gem. 2013-05-23 14:51:56 -07:00
asseturl.patch Standardize on image-path for referencing sprite assets. 2012-11-01 10:56:58 -04:00
bootstrap-sass.gemspec Upgrade to 2.3.1 from official upstream. 2013-03-12 13:22:07 -04:00

README.md

Bootstrap for Sass

bootstrap-sass is an Sass-powered version of Twitter's Bootstrap, ready to drop right into your Sass powered applications.

Usage

Rails

In your Gemfile:

gem 'sass-rails',   '~> 3.2.3'
gem 'bootstrap-sass', :git => 'git://github.com/intridea/bootstrap-sass.git', :branch => '3.0.0-wip'

bundle install and restart your server to make the files available.

Upstream Converter

Keeping bootstrap-sass in sync with upsteam changes from Bootstrap is an error prone and time consuming manual process. This branch is specifically concerned with automating that process as much as possible to allow a much faster release cycle.

Upsteam changes to the Twitter 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 twitter/bootstrap repo:

% bundle exec rake 'convert[3.0.0-wip]'

The latest converter script is located here and does the following:

  • Converts upsteam bootstrap Less files to its matching Scss file.
  • Copies all upstream javascripts 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 necessary for now. See these github issues tagged with conversion which track the current shortcomings of the conversion process.

Who

bootstrap-sass is a project by Thomas McDonald, with support from other awesome people.