{
  "name": "bootstrap-sass",
  "version": "3.2.0",
  "description": "bootstrap-sass is a Sass-powered version of Bootstrap, ready to drop right into your Sass powered applications.",
  "main": "index.js",
  "repository": {
    "type": "git",
    "url": "git://github.com/twbs/bootstrap-sass"
  },
  "keywords": [
    "bootstrap",
    "sass",
    "css"
  ],
  "contributors": [
    {
      "name": "Thomas McDonald"
    },
    {
      "name": "Tristan Harward"
    },
    {
      "name": "Peter Gumeson"
    },
    {
      "name": "Gleb Mazovetskiy"
    }
  ],
  "license": "MIT",
  "bugs": {
    "url": "https://github.com/twbs/bootstrap-sass/issues"
  },
  "readme": "# Bootstrap for Sass [![Gem Version](https://badge.fury.io/rb/bootstrap-sass.svg)](http://badge.fury.io/rb/bootstrap-sass) [![Bower Version](https://badge.fury.io/bo/bootstrap-sass-official.svg)](http://badge.fury.io/bo/bootstrap-sass-official) [![Build Status](http://img.shields.io/travis/twbs/bootstrap-sass.svg)](http://travis-ci.org/twbs/bootstrap-sass)\n\n`bootstrap-sass` is a Sass-powered version of [Bootstrap](http://github.com/twbs/bootstrap), ready to drop right into your Sass powered applications.\n\n## Installation\n\nPlease see the appropriate guide for your environment of choice:\n\n### a. Ruby on Rails\n\n`bootstrap-sass` is easy to drop into Rails with the asset pipeline.\n\nIn your Gemfile you need to add the `bootstrap-sass` gem, and ensure that the `sass-rails` gem is present - it is added to new Rails applications by default.\n\n```ruby\ngem 'bootstrap-sass', '~> 3.2.0'\ngem 'sass-rails', '>= 3.2'\n```\n\nIt is also recommended to use [Autoprefixer](https://github.com/ai/autoprefixer-rails) with Bootstrap\nto add browser vendor prefixes automatically. Simply add the gem:\n\n```ruby\ngem 'autoprefixer-rails'\n```\n\n`bundle install` and restart your server to make the files available through the pipeline.\n\nIn `app/assets/application.css.sass`:\n\n```sass\n@import \"bootstrap-sprockets\"\n@import \"bootstrap\"\n```\n\nDo not use `//= require` in Sass or your other stylesheets will not be [able to access][antirequire] the Bootstrap mixins or variables.\n\nIn `app/assets/application.js`:\n\n```js\n//= require jquery\n//= require bootstrap-sprockets\n```\n\n#### Rails 3.2.x\n\nRails 3.2 is [no longer maintained for bugfixes](http://guides.rubyonrails.org/maintenance_policy.html), and you should upgrade as soon as possible.\n\nStarting with bootstrap-sass v3.1.1.1, due to the structural changes from upstream you will need these\nbackported asset pipeline gems on Rails 3.2. There is more on why this is necessary in\nhttps://github.com/twbs/bootstrap-sass/issues/523 and https://github.com/twbs/bootstrap-sass/issues/578.\n\n```ruby\ngem 'sprockets-rails', '=2.0.0.backport1'\ngem 'sprockets', '=2.2.2.backport2'\ngem 'sass-rails', github: 'guilleiguaran/sass-rails', branch: 'backport'\n```\n\n### b. Compass without Rails\n\nInstall the gem\n```sh\ngem install bootstrap-sass\n```\n\nIf you have an existing Compass project:\n\n```ruby\n# config.rb:\nrequire 'bootstrap-sass'\n```\n\n```console\n$ bundle exec compass install bootstrap\n```\n\nIf you are creating a new Compass project, you can generate it with bootstrap-sass support:\n\n```console\n$ bundle exec compass create my-new-project -r bootstrap-sass --using bootstrap\n```\n\nor, alternatively, if you're not using a Gemfile for your dependencies:\n\n```console\n$ compass create my-new-project -r bootstrap-sass --using bootstrap\n```\n\nThis will create a new Compass project with the following files in it:\n\n* [styles.sass](/templates/project/styles.sass) - main project Sass file, imports Bootstrap and variables.\n* [_bootstrap-variables.sass](/templates/project/_bootstrap-variables.sass.erb) - all of Bootstrap variables, override them here.\n\nSome bootstrap-sass mixins may conflict with the Compass ones.\nIf this happens, change the import order so that Compass mixins are loaded later.\n\n### c. Bower\n\nUsing bootstrap-sass as a Bower package is still being tested. It is compatible with node-sass 0.8.3+. You can install it with:\n\n```console\n$ bower install bootstrap-sass-official\n```\n\n`bootstrap-sass` is taken so make sure you use the command above.\n\nSass, JS, and all other assets are located at [assets](/assets).\n\nBy default, `bower.json` main field list only the main `bootstrap.scss` and all the static assets (fonts and JS).\nThis is compatible by default with asset managers such as [wiredep](https://github.com/taptapship/wiredep).\n\n#### Node.js Mincer\n\nIf you use [mincer][mincer] with node-sass, import bootstrap into like so:\n\nIn `application.css.ejs.scss` (NB **.css.ejs.css**):\n\n```scss\n// Import mincer asset paths helper integration\n@import \"bootstrap-mincer\";\n@import \"bootstrap\";\n```\n\nIn `application.js`:\n\n```js\n//= require bootstrap-sprockets\n```\n\nSee also this [example manifest.js](/test/dummy_node_mincer/manifest.js) for mincer.\n\n\n### Configuration\n\n#### Sass\n\nBy default all of Bootstrap is imported.\n\nYou can also import components explicitly. To start with a full list of modules copy\n[`bootstrap.scss`](assets/stylesheets/bootstrap.scss) file into your assets as `bootstrap-custom.scss`.\nThen comment out components you do not want from `bootstrap-custom`.\nIn the application Sass file, replace `@import 'bootstrap'` with:\n\n```sass\n@import 'bootstrap-custom'\n```\n\n#### Sass: Number Precision\n\nbootstrap-sass [requires](https://github.com/twbs/bootstrap-sass/issues/409) minimum [Sass number precision][sass-precision] of 10 (default is 5).\n\nPrecision is set for Rails and Compass automatically.\nWhen using ruby Sass compiler standalone or with the Bower version you can set it with:\n\n```ruby\n::Sass::Script::Number.precision = [10, ::Sass::Script::Number.precision].max\n```\n\nNote that libsass and node-sass do not currently support the precision option, due to an open bug ([bug #364](https://github.com/sass/libsass/issues/364)) in libsass.\n\n\n#### Sass: Autoprefixer\n\nUsing [Autoprefixer][autoprefixer] with Bootstrap is recommended.\n[Autoprefixer][autoprefixer] adds vendor prefixes to CSS rules using values from [Can I Use](http://caniuse.com/).\n\n#### JavaScript\n\n[`assets/javascripts/bootstrap.js`](/assets/javascripts/bootstrap.js) contains all of Bootstrap JavaScript,\nconcatenated in the [correct order](/assets/javascripts/bootstrap-sprockets.js).\n\n\n#### JavaScript with Sprockets or Mincer\n\nIf you use Sprockets or Mincer, you can require `bootstrap-sprockets` instead to load the individual modules:\n\n```js\n// Load all Bootstrap JavaScript\n//= require bootstrap-sprockets\n```\n\nYou can also load individual modules, provided you also require any dependencies.\nYou can check dependencies in the [Bootstrap JS documentation][jsdocs].\n\n```js\n//= require bootstrap/scrollspy\n//= require bootstrap/modal\n//= require bootstrap/dropdown\n```\n\n#### Fonts\n\nThe fonts are referenced as:\n\n```sass\n\"#{$icon-font-path}#{$icon-font-name}.eot\"\n```\n\n`$icon-font-path` defaults to `bootstrap/`.\n\nWhen using with Compass, Sprockets, or Mincer, make sure to import the relevant path helpers before Bootstrap itself, for example:.\n\n```sass\n@import bootstrap-compass\n@import bootstrap\n```\n\n## Usage\n\n### Sass\n\nImport Bootstrap into a Sass file (for example, application.css.scss) to get all of Bootstrap's styles, mixins and variables!\n\n```scss\n@import \"bootstrap\";\n```\n\nYou can also include optional bootstrap theme:\n\n```scss\n@import \"bootstrap/theme\";\n```\n\nThe 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, e.g.:\n\n```scss\n$navbar-default-bg: #312312;\n$light-orange: #ff8c00;\n$navbar-default-color: $light-orange;\n\n@import \"bootstrap\";\n```\n\n---\n\n## Development and Contributing\n\nIf you'd like to help with the development of bootstrap-sass itself, read this section.\n\n### Upstream Converter\n\nKeeping 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.\n\n**Note: if you're just looking to *use* Bootstrap 3, see the [installation](#installation) section above.**\n\nUpstream changes to the Bootstrap project can now be pulled in using the `convert` rake task.\n\nHere's an example run that would pull down the master branch from the main [twbs/bootstrap](https://github.com/twbs/bootstrap) repo:\n\n    rake convert\n\nThis will convert the latest LESS to Sass and update to the latest JS.\nTo convert a specific branch or version, pass the branch name or the commit hash as the first task argument:\n\n    rake convert[e8a1df5f060bf7e6631554648e0abde150aedbe4]\n\nThe latest converter script is located [here][converter] and does the following:\n\n* Converts upstream bootstrap LESS files to its matching SCSS file.\n* Copies all upstream JavaScript into `assets/javascripts/bootstrap`, an Sprockets manifest at `assets/javascripts/bootstrap-sprockets.js`, and a concatenation at `assets/javascripts/bootstrap.js`.\n* Copies all upstream font files into `assets/fonts/bootstrap`.\n* Sets `Bootstrap::BOOTSTRAP_SHA` in [version.rb][version] to the branch sha.\n\nThis converter fully converts original LESS to SCSS. Conversion is automatic but requires instructions for certain transformations (see converter output).\nPlease submit GitHub issues tagged with `conversion`.\n\n## Credits\n\nbootstrap-sass has a number of major contributors:\n\n<!-- feel free to make these link wherever you wish -->\n* [Thomas McDonald](https://twitter.com/thomasmcdonald_)\n* [Tristan Harward](http://www.trisweb.com)\n* Peter Gumeson\n* [Gleb Mazovetskiy](https://github.com/glebm)\n\nand a [significant number of other contributors][contrib].\n\n## You're in good company\nbootstrap-sass is used to build some awesome projects all over the web, including\n[Diaspora](http://diasporaproject.org/), [rails_admin](https://github.com/sferik/rails_admin),\nMichael Hartl's [Rails Tutorial](http://railstutorial.org/), [gitlabhq](http://gitlabhq.com/) and\n[kandan](http://kandanapp.com/).\n\n[converter]: https://github.com/twbs/bootstrap-sass/blob/master/tasks/converter/less_conversion.rb\n[version]: https://github.com/twbs/bootstrap-sass/blob/master/lib/bootstrap-sass/version.rb\n[contrib]: https://github.com/twbs/bootstrap-sass/graphs/contributors\n[antirequire]: https://github.com/twbs/bootstrap-sass/issues/79#issuecomment-4428595\n[jsdocs]: http://getbootstrap.com/javascript/#transitions\n[sass-precision]: http://sass-lang.com/documentation/Sass/Script/Number.html#precision-class_method\n[mincer]: https://github.com/nodeca/mincer\n[autoprefixer]: https://github.com/ai/autoprefixer\n",
  "readmeFilename": "README.md",
  "homepage": "https://github.com/twbs/bootstrap-sass",
  "_id": "bootstrap-sass@3.2.0",
  "_shasum": "e5fb0f4f1dc7d7f5f067664843a5470b152597e5",
  "_from": "bootstrap-sass@",
  "_resolved": "https://registry.npmjs.org/bootstrap-sass/-/bootstrap-sass-3.2.0.tgz"
}