bootstrap-sass-backport 3.2.0.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gitignore +19 -0
- data/.travis.yml +19 -0
- data/CHANGELOG.md +146 -0
- data/CONTRIBUTING.md +79 -0
- data/Gemfile +10 -0
- data/LICENSE +21 -0
- data/README.md +320 -0
- data/Rakefile +54 -0
- data/assets/fonts/bootstrap/glyphicons-halflings-regular.eot +0 -0
- data/assets/fonts/bootstrap/glyphicons-halflings-regular.svg +229 -0
- data/assets/fonts/bootstrap/glyphicons-halflings-regular.ttf +0 -0
- data/assets/fonts/bootstrap/glyphicons-halflings-regular.woff +0 -0
- data/assets/images/.keep +0 -0
- data/assets/javascripts/bootstrap-sprockets.js +12 -0
- data/assets/javascripts/bootstrap.js +2107 -0
- data/assets/javascripts/bootstrap/affix.js +142 -0
- data/assets/javascripts/bootstrap/alert.js +92 -0
- data/assets/javascripts/bootstrap/button.js +110 -0
- data/assets/javascripts/bootstrap/carousel.js +223 -0
- data/assets/javascripts/bootstrap/collapse.js +170 -0
- data/assets/javascripts/bootstrap/dropdown.js +151 -0
- data/assets/javascripts/bootstrap/modal.js +280 -0
- data/assets/javascripts/bootstrap/popover.js +113 -0
- data/assets/javascripts/bootstrap/scrollspy.js +170 -0
- data/assets/javascripts/bootstrap/tab.js +128 -0
- data/assets/javascripts/bootstrap/tooltip.js +457 -0
- data/assets/javascripts/bootstrap/transition.js +59 -0
- data/assets/stylesheets/_bootstrap-compass.scss +7 -0
- data/assets/stylesheets/_bootstrap-mincer.scss +17 -0
- data/assets/stylesheets/_bootstrap-sprockets.scss +7 -0
- data/assets/stylesheets/_bootstrap.scss +50 -0
- data/assets/stylesheets/bootstrap/_alerts.scss +68 -0
- data/assets/stylesheets/bootstrap/_badges.scss +57 -0
- data/assets/stylesheets/bootstrap/_breadcrumbs.scss +26 -0
- data/assets/stylesheets/bootstrap/_button-groups.scss +240 -0
- data/assets/stylesheets/bootstrap/_buttons.scss +157 -0
- data/assets/stylesheets/bootstrap/_carousel.scss +243 -0
- data/assets/stylesheets/bootstrap/_close.scss +35 -0
- data/assets/stylesheets/bootstrap/_code.scss +68 -0
- data/assets/stylesheets/bootstrap/_component-animations.scss +35 -0
- data/assets/stylesheets/bootstrap/_dropdowns.scss +215 -0
- data/assets/stylesheets/bootstrap/_forms.scss +538 -0
- data/assets/stylesheets/bootstrap/_glyphicons.scss +237 -0
- data/assets/stylesheets/bootstrap/_grid.scss +84 -0
- data/assets/stylesheets/bootstrap/_input-groups.scss +166 -0
- data/assets/stylesheets/bootstrap/_jumbotron.scss +48 -0
- data/assets/stylesheets/bootstrap/_labels.scss +66 -0
- data/assets/stylesheets/bootstrap/_list-group.scss +131 -0
- data/assets/stylesheets/bootstrap/_media.scss +56 -0
- data/assets/stylesheets/bootstrap/_mixins.scss +39 -0
- data/assets/stylesheets/bootstrap/_modals.scss +150 -0
- data/assets/stylesheets/bootstrap/_navbar.scss +659 -0
- data/assets/stylesheets/bootstrap/_navs.scss +242 -0
- data/assets/stylesheets/bootstrap/_normalize.scss +425 -0
- data/assets/stylesheets/bootstrap/_pager.scss +55 -0
- data/assets/stylesheets/bootstrap/_pagination.scss +88 -0
- data/assets/stylesheets/bootstrap/_panels.scss +243 -0
- data/assets/stylesheets/bootstrap/_popovers.scss +133 -0
- data/assets/stylesheets/bootstrap/_print.scss +101 -0
- data/assets/stylesheets/bootstrap/_progress-bars.scss +105 -0
- data/assets/stylesheets/bootstrap/_responsive-embed.scss +34 -0
- data/assets/stylesheets/bootstrap/_responsive-utilities.scss +174 -0
- data/assets/stylesheets/bootstrap/_scaffolding.scss +150 -0
- data/assets/stylesheets/bootstrap/_tables.scss +233 -0
- data/assets/stylesheets/bootstrap/_theme.scss +258 -0
- data/assets/stylesheets/bootstrap/_thumbnails.scss +38 -0
- data/assets/stylesheets/bootstrap/_tooltip.scss +95 -0
- data/assets/stylesheets/bootstrap/_type.scss +304 -0
- data/assets/stylesheets/bootstrap/_utilities.scss +57 -0
- data/assets/stylesheets/bootstrap/_variables.scss +854 -0
- data/assets/stylesheets/bootstrap/_wells.scss +29 -0
- data/assets/stylesheets/bootstrap/mixins/_alerts.scss +14 -0
- data/assets/stylesheets/bootstrap/mixins/_background-variant.scss +11 -0
- data/assets/stylesheets/bootstrap/mixins/_border-radius.scss +18 -0
- data/assets/stylesheets/bootstrap/mixins/_buttons.scss +50 -0
- data/assets/stylesheets/bootstrap/mixins/_center-block.scss +7 -0
- data/assets/stylesheets/bootstrap/mixins/_clearfix.scss +22 -0
- data/assets/stylesheets/bootstrap/mixins/_forms.scss +84 -0
- data/assets/stylesheets/bootstrap/mixins/_gradients.scss +58 -0
- data/assets/stylesheets/bootstrap/mixins/_grid-framework.scss +81 -0
- data/assets/stylesheets/bootstrap/mixins/_grid.scss +122 -0
- data/assets/stylesheets/bootstrap/mixins/_hide-text.scss +21 -0
- data/assets/stylesheets/bootstrap/mixins/_image.scss +34 -0
- data/assets/stylesheets/bootstrap/mixins/_labels.scss +12 -0
- data/assets/stylesheets/bootstrap/mixins/_list-group.scss +31 -0
- data/assets/stylesheets/bootstrap/mixins/_nav-divider.scss +10 -0
- data/assets/stylesheets/bootstrap/mixins/_nav-vertical-align.scss +9 -0
- data/assets/stylesheets/bootstrap/mixins/_opacity.scss +8 -0
- data/assets/stylesheets/bootstrap/mixins/_pagination.scss +23 -0
- data/assets/stylesheets/bootstrap/mixins/_panels.scss +24 -0
- data/assets/stylesheets/bootstrap/mixins/_progress-bar.scss +10 -0
- data/assets/stylesheets/bootstrap/mixins/_reset-filter.scss +8 -0
- data/assets/stylesheets/bootstrap/mixins/_resize.scss +6 -0
- data/assets/stylesheets/bootstrap/mixins/_responsive-visibility.scss +21 -0
- data/assets/stylesheets/bootstrap/mixins/_size.scss +10 -0
- data/assets/stylesheets/bootstrap/mixins/_tab-focus.scss +9 -0
- data/assets/stylesheets/bootstrap/mixins/_table-row.scss +28 -0
- data/assets/stylesheets/bootstrap/mixins/_text-emphasis.scss +11 -0
- data/assets/stylesheets/bootstrap/mixins/_text-overflow.scss +8 -0
- data/assets/stylesheets/bootstrap/mixins/_vendor-prefixes.scss +219 -0
- data/bootstrap-sass-backport.gemspec +36 -0
- data/bower.json +50 -0
- data/composer.json +35 -0
- data/lib/bootstrap-sass-backport.rb +71 -0
- data/lib/bootstrap-sass/engine.rb +12 -0
- data/lib/bootstrap-sass/version.rb +4 -0
- data/package.json +30 -0
- data/sache.json +5 -0
- data/tasks/bower.rake +34 -0
- data/tasks/converter.rb +80 -0
- data/tasks/converter/char_string_scanner.rb +38 -0
- data/tasks/converter/fonts_conversion.rb +16 -0
- data/tasks/converter/js_conversion.rb +45 -0
- data/tasks/converter/less_conversion.rb +670 -0
- data/tasks/converter/logger.rb +57 -0
- data/tasks/converter/network.rb +86 -0
- data/templates/project/_bootstrap-variables.sass.erb +4 -0
- data/templates/project/manifest.rb +26 -0
- data/templates/project/styles.sass +3 -0
- data/test/compass_test.rb +9 -0
- data/test/compilation_test.rb +18 -0
- data/test/dummy_node_mincer/apple-touch-icon-144-precomposed.png +0 -0
- data/test/dummy_node_mincer/application.css.ejs.scss +6 -0
- data/test/dummy_node_mincer/manifest.js +87 -0
- data/test/dummy_rails/README.rdoc +3 -0
- data/test/dummy_rails/Rakefile +6 -0
- data/test/dummy_rails/app/assets/images/.keep +0 -0
- data/test/dummy_rails/app/assets/javascripts/application.js +2 -0
- data/test/dummy_rails/app/assets/stylesheets/application.css.sass +2 -0
- data/test/dummy_rails/app/controllers/application_controller.rb +5 -0
- data/test/dummy_rails/app/controllers/pages_controller.rb +4 -0
- data/test/dummy_rails/app/helpers/application_helper.rb +2 -0
- data/test/dummy_rails/app/views/layouts/application.html.erb +14 -0
- data/test/dummy_rails/app/views/pages/root.html.slim +41 -0
- data/test/dummy_rails/bin/bundle +3 -0
- data/test/dummy_rails/bin/rails +4 -0
- data/test/dummy_rails/bin/rake +4 -0
- data/test/dummy_rails/config.ru +4 -0
- data/test/dummy_rails/config/application.rb +30 -0
- data/test/dummy_rails/config/boot.rb +5 -0
- data/test/dummy_rails/config/environment.rb +5 -0
- data/test/dummy_rails/config/environments/development.rb +26 -0
- data/test/dummy_rails/config/environments/production.rb +76 -0
- data/test/dummy_rails/config/environments/test.rb +30 -0
- data/test/dummy_rails/config/initializers/backtrace_silencers.rb +7 -0
- data/test/dummy_rails/config/initializers/filter_parameter_logging.rb +4 -0
- data/test/dummy_rails/config/initializers/inflections.rb +16 -0
- data/test/dummy_rails/config/initializers/mime_types.rb +5 -0
- data/test/dummy_rails/config/initializers/secret_token.rb +18 -0
- data/test/dummy_rails/config/initializers/session_store.rb +3 -0
- data/test/dummy_rails/config/initializers/wrap_parameters.rb +14 -0
- data/test/dummy_rails/config/locales/en.yml +3 -0
- data/test/dummy_rails/config/locales/es.yml +3 -0
- data/test/dummy_rails/config/routes.rb +3 -0
- data/test/dummy_rails/db/test.sqlite3 +0 -0
- data/test/dummy_rails/lib/assets/.keep +0 -0
- data/test/dummy_rails/log/.keep +0 -0
- data/test/dummy_rails/public/404.html +58 -0
- data/test/dummy_rails/public/422.html +58 -0
- data/test/dummy_rails/public/500.html +57 -0
- data/test/dummy_rails/public/favicon.ico +0 -0
- data/test/dummy_sass_only/Gemfile +4 -0
- data/test/dummy_sass_only/compile.rb +13 -0
- data/test/dummy_sass_only/import_all.sass +2 -0
- data/test/gemfiles/sass_3_2.gemfile +6 -0
- data/test/gemfiles/sass_3_3.gemfile +6 -0
- data/test/gemfiles/sass_3_4.gemfile +7 -0
- data/test/gemfiles/sass_head.gemfile +6 -0
- data/test/node_mincer_test.rb +36 -0
- data/test/node_sass_test.rb +16 -0
- data/test/pages_test.rb +14 -0
- data/test/sass_test.rb +26 -0
- data/test/sprockets_rails_test.rb +27 -0
- data/test/support/dummy_rails_integration.rb +22 -0
- data/test/support/integration_test.rb +22 -0
- data/test/support/reporting.rb +17 -0
- data/test/test_helper.rb +35 -0
- data/test/test_helper_rails.rb +6 -0
- metadata +484 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: 90ea1065ae6d2fd33aeeb9819e3038dc2a57b0f3
|
4
|
+
data.tar.gz: 7faa8f11248446aa1c0a68df588bd714b98a8aef
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 959828544b9274510086cb3f74ef3c4fd711df71cd5fe7aace4735042518eb62f7b79fec76122e26aaac014bcf72b3850bd146cc28571d0cdc38477c4ddcef17
|
7
|
+
data.tar.gz: 5c202cad05dec02ae455f1a0cf70a9dac4e02b74171ae1e1410135d27ad772601885490ff19417d14cde495c936e1881fe935456605c1a664776ceeb688ce8b2
|
data/.gitignore
ADDED
@@ -0,0 +1,19 @@
|
|
1
|
+
*.gem
|
2
|
+
.sass-cache
|
3
|
+
bootstrap.css
|
4
|
+
bootstrap-responsive.css
|
5
|
+
Gemfile.lock
|
6
|
+
*.gemfile.lock
|
7
|
+
.rvmrc
|
8
|
+
.rbenv-version
|
9
|
+
|
10
|
+
# Ignore bundler config
|
11
|
+
/.bundle
|
12
|
+
/vendor/cache
|
13
|
+
/vendor/bundle
|
14
|
+
tmp/
|
15
|
+
test/screenshots/
|
16
|
+
test/dummy_rails/log/*.log
|
17
|
+
|
18
|
+
.DS_Store
|
19
|
+
node_modules
|
data/.travis.yml
ADDED
@@ -0,0 +1,19 @@
|
|
1
|
+
language: ruby
|
2
|
+
rvm:
|
3
|
+
- 2.1.1
|
4
|
+
- 2.0.0
|
5
|
+
- jruby
|
6
|
+
- rbx-2
|
7
|
+
gemfile:
|
8
|
+
- test/gemfiles/sass_3_2.gemfile
|
9
|
+
- test/gemfiles/sass_3_3.gemfile
|
10
|
+
- test/gemfiles/sass_head.gemfile
|
11
|
+
before_install:
|
12
|
+
- "npm install"
|
13
|
+
matrix:
|
14
|
+
allow_failures:
|
15
|
+
# rbx has issues https://github.com/rubinius/rubinius/issues/3060
|
16
|
+
- rvm: rbx-2
|
17
|
+
- gemfile: test/gemfiles/sass_head.gemfile
|
18
|
+
notifications:
|
19
|
+
slack: heybb:3n88HHilXn76ji9vV4gL819Y
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,146 @@
|
|
1
|
+
# Changelog
|
2
|
+
|
3
|
+
## 3.2.0.2
|
4
|
+
|
5
|
+
Main bootstrap file is now a partial (_bootstrap.scss), for compatibility with Compass 1+.
|
6
|
+
|
7
|
+
Fixed a number of bugs. [Issues closed in v3.2.0.2](https://github.com/twbs/bootstrap-sass/issues?q=is%3Aissue+is%3Aclosed+milestone%3Av3.2.0.2).
|
8
|
+
|
9
|
+
## 3.2.0.1
|
10
|
+
|
11
|
+
Fixed a number of bugs: [Issues closed in v3.2.0.1](https://github.com/twbs/bootstrap-sass/issues?q=is%3Aissue+is%3Aclosed+milestone%3Av3.2.0.1).
|
12
|
+
|
13
|
+
## 3.2.0.0
|
14
|
+
|
15
|
+
- Assets (Sass, JS, fonts) moved from `vendor/assets` to `assets`. `bootstrap.js` now contains concatenated JS.
|
16
|
+
- Compass generator now copies JS and fonts, and provides a better default `styles.sass`.
|
17
|
+
- Compass, Sprockets, and Mincer asset path helpers are now provided in pure Sass: `bootstrap-compass`, `bootstrap-sprockets`, and `bootstrap-mincer`.
|
18
|
+
Asset path helpers must be imported before `bootstrap`, more in Readme.
|
19
|
+
- Sprockets / Mincer JS manifest has been moved to `bootstrap-sprockets.js`.
|
20
|
+
It can be required without adding Bootstrap JS directory to load path, as it now uses relative paths.
|
21
|
+
- Sprockets: `depend_on_asset` (`glyphicons.scss`) has been changed to `depend_on` to work around an issue with `depend_on_asset`.
|
22
|
+
[More information](https://github.com/twbs/bootstrap-sass/issues/592#issuecomment-46570286).
|
23
|
+
|
24
|
+
## 3.1.1.0
|
25
|
+
|
26
|
+
- Updated Bower docs
|
27
|
+
|
28
|
+
## 3.1.0.2
|
29
|
+
|
30
|
+
- #523: Rails 3.2 compatibility
|
31
|
+
- Bugfixes from upstream up to 7eb532262fbd1112215b5a547b9285794b5360ab.
|
32
|
+
|
33
|
+
## 3.1.0.1
|
34
|
+
|
35
|
+
- #518: `scale` mixin Sass compatibility issue
|
36
|
+
|
37
|
+
## 3.1.0.0
|
38
|
+
|
39
|
+
* compiles with libsass master
|
40
|
+
|
41
|
+
## 3.0.2.1
|
42
|
+
|
43
|
+
* fix vendor paths for compass
|
44
|
+
|
45
|
+
## 3.0.0.0
|
46
|
+
|
47
|
+
* Fully automated (lots of string juggling) LESS -> Sass conversion. - *Gleb Mazovetskiy*
|
48
|
+
* Ported rake task from vwall/compass-twitter-bootstrap to convert Bootstrap upstream - *Peter Gumeson*
|
49
|
+
* Moved javascripts to us `bootstrap-component.js` to `bootstrap/component.js` - *Peter Gumeson*
|
50
|
+
|
51
|
+
## 2.3.2.2
|
52
|
+
|
53
|
+
* Allow sass-rails `>= 3.2` - *Thomas McDonald*
|
54
|
+
|
55
|
+
## 2.3.2.1
|
56
|
+
|
57
|
+
## 2.3.2.0
|
58
|
+
|
59
|
+
* Update to Bootstrap 2.3.2 - *Dan Allen*
|
60
|
+
|
61
|
+
## 2.3.1.3
|
62
|
+
|
63
|
+
* Find the correct Sprockets context for the `image_path` function - *Tristan Harward, Gleb Mazovetskiy*
|
64
|
+
|
65
|
+
## 2.3.1.2
|
66
|
+
|
67
|
+
* Fix changes to image url - *Gleb Mazovetskiy*
|
68
|
+
* Copy _variables into project on Compass install - *Phil Thompson*
|
69
|
+
* Add `bootstrap-affix` to the Compass template file - *brief*
|
70
|
+
|
71
|
+
## 2.3.1.1 (yanked)
|
72
|
+
|
73
|
+
* Change how image_url is handled internally - *Tristan Harward*
|
74
|
+
* Fix some font variables not having `!default` - *Thomas McDonald*
|
75
|
+
|
76
|
+
## 2.3.0.0
|
77
|
+
* [#290] Update to Bootstrap 2.3.0 - *Tristan Harward*
|
78
|
+
* Fix `rake:debug` with new file locations - *Thomas McDonald*
|
79
|
+
* Add draft contributing document - *Thomas McDonald*
|
80
|
+
* [#260] Add our load path to the global Sass load path - *Tristan Harward*
|
81
|
+
* [#275] Use GitHub notation in Sass head testing gemfile - *Timo Schilling*
|
82
|
+
* [#279, #283] Readme improvements - *theverything, Philip Arndt*
|
83
|
+
|
84
|
+
## 2.2.2.0
|
85
|
+
* [#270] Update to Bootstrap 2.2.2 - *Tristan Harward*
|
86
|
+
* [#266] Add license to gemspec - *Peter Marsh*
|
87
|
+
|
88
|
+
## 2.2.1.1
|
89
|
+
* [#258] Use `bootstrap` prefix for `@import`ing files in `bootstrap/bootstrap.scss` - *Umair Siddique*
|
90
|
+
|
91
|
+
## 2.2.1.0
|
92
|
+
* [#246] Update to Bootstrap 2.2.1 - *Tristan Harward*
|
93
|
+
* [#246] Pull Bootstrap updates from jlong/sass-twitter-bootstrap - *Tristan Harward*
|
94
|
+
|
95
|
+
## 2.1.1.0
|
96
|
+
* Update to Bootstrap 2.1.1
|
97
|
+
* [#222] Remove 100% multiplier in vertical-three-colours
|
98
|
+
* [#227] Fix IE component animation collapse
|
99
|
+
* [#228] Fix variables documentation link
|
100
|
+
* [#231] Made .input-block-level a class as well as mixin
|
101
|
+
|
102
|
+
## 2.1.0.1
|
103
|
+
* [#219] Fix expected a color. Got: transparent.
|
104
|
+
* [#207] Add missing warning style for table row highlighting
|
105
|
+
* [#208] Use grid-input-span for input spans
|
106
|
+
|
107
|
+
## 2.1.0.0
|
108
|
+
* Updated to Bootstrap 2.1
|
109
|
+
* Changed some mixin names to be more consistent. Nested mixins in Less are separated by a `-` when they are flattened in Sass.
|
110
|
+
|
111
|
+
## 2.0.4.1
|
112
|
+
* Fix `.row-fluid > spanX` nesting
|
113
|
+
* Small Javascript fixes for those staying on the 2.0.4 release
|
114
|
+
* Add `!default` to z-index variables.
|
115
|
+
|
116
|
+
## 2.0.4.0
|
117
|
+
* Updated to Bootstrap 2.0.4
|
118
|
+
* Switched to Bootstrap 2.0.3+'s method of separating responsive files
|
119
|
+
* [#149, #150] Fix off by one error introduced with manual revert of media query breakpoints
|
120
|
+
* `rake debug` and `rake test` both compile bootstrap & bootstrap-responsive
|
121
|
+
|
122
|
+
## 2.0.3.1
|
123
|
+
* [#145, #146] Fix button alignment in collapsing navbar as a result of an incorrect variable
|
124
|
+
|
125
|
+
## 2.0.3
|
126
|
+
* Updated to Bootstrap 2.0.3
|
127
|
+
* [#106] Support for Rails < 3.1 through Compass
|
128
|
+
* [#132] Add CI testing
|
129
|
+
* [#106] Support Rails w/Compass
|
130
|
+
* [#134] Fix support for Rails w/Compass
|
131
|
+
|
132
|
+
## 2.0.2
|
133
|
+
* [#86] Updated to Bootstrap 2.0.2
|
134
|
+
Things of note: static navbars now have full width. (to be fixed in 2.0.3) `.navbar-inner > .container { width:940px; }` seems to work in the meanwhile
|
135
|
+
* [#62] Fixed asset compilation taking a *very* long time.
|
136
|
+
* [#69, #79, #80] \(Hopefully) clarified README. Now with less cat humour.
|
137
|
+
* [#91] Removed doubled up Sass extensions for Rails.
|
138
|
+
* [#63, #73] Allow for overriding of image-path
|
139
|
+
* [[SO](http://stackoverflow.com/a/9909626/241212)] Added makeFluidColumn mixin for defining fluid columns. Fluid rows must use `@extend .row-fluid`, and any column inside it can use `@include makeFluidColumn(num)`, where `num` is the number of columns. Unfortunately, there is a rather major limitation to this: margins on first-child elements must be overriden. See the attached Stack Overflow answer for more information.
|
140
|
+
|
141
|
+
## 2.0.1
|
142
|
+
* Updated to Bootstrap 2.0.1
|
143
|
+
* Modified `@mixin opacity()` to take an argument `0...1` rather than `0...100` to be consistent with Compass.
|
144
|
+
|
145
|
+
## 2.0.0
|
146
|
+
* Updated to Bootstrap 2.0.0
|
data/CONTRIBUTING.md
ADDED
@@ -0,0 +1,79 @@
|
|
1
|
+
# Contributing to bootstrap-sass
|
2
|
+
|
3
|
+
## Asset Changes
|
4
|
+
|
5
|
+
Any changes to `bootstrap-sass` assets (scss, javascripts, fonts) should be checked against the `convert` rake task.
|
6
|
+
For usage instructions, see the [README](/README.md).
|
7
|
+
|
8
|
+
If something is broken in the converter, it's preferable to update the converter along with the asset itself.
|
9
|
+
|
10
|
+
|
11
|
+
## Bugs
|
12
|
+
|
13
|
+
A bug is a _demonstrable problem_ that is caused by the code in the
|
14
|
+
repository. Good bug reports are extremely helpful - thank you!
|
15
|
+
|
16
|
+
Guidelines for bug reports:
|
17
|
+
|
18
|
+
1. **Does it belong here?** — is this a problem with bootstrap-sass, or
|
19
|
+
it an issue with [twbs/bootstrap](https://github.com/twbs/bootstrap)?
|
20
|
+
We only distribute a direct port and will not modify files if they're not
|
21
|
+
changed upstream.
|
22
|
+
|
23
|
+
2. **Use the GitHub issue search** — check if the issue has already been
|
24
|
+
reported.
|
25
|
+
|
26
|
+
3. **Isolate the problem** — ideally create a [reduced test
|
27
|
+
case](http://css-tricks.com/6263-reduced-test-cases/) and a live example.
|
28
|
+
|
29
|
+
A good bug report shouldn't leave others needing to chase you up for more
|
30
|
+
information. Please try to be as detailed as possible in your report. What is
|
31
|
+
your environment? What steps will reproduce the issue? What browser(s) and OS
|
32
|
+
experience the problem? What would you expect to be the outcome? All these
|
33
|
+
details will help people to fix any potential bugs.
|
34
|
+
|
35
|
+
Example:
|
36
|
+
|
37
|
+
> Short and descriptive example bug report title
|
38
|
+
>
|
39
|
+
> A summary of the issue and the browser/OS environment in which it occurs. If
|
40
|
+
> suitable, include the steps required to reproduce the bug.
|
41
|
+
>
|
42
|
+
> 1. This is the first step
|
43
|
+
> 2. This is the second step
|
44
|
+
> 3. Further steps, etc.
|
45
|
+
>
|
46
|
+
> `<url>` (a link to the reduced test case)
|
47
|
+
>
|
48
|
+
> Any other information you want to share that is relevant to the issue being
|
49
|
+
> reported. This might include the lines of code that you have identified as
|
50
|
+
> causing the bug, and potential solutions (and your opinions on their
|
51
|
+
> merits).
|
52
|
+
|
53
|
+
**[File a bug report](https://github.com/twbs/bootstrap-sass/issues/)**
|
54
|
+
|
55
|
+
|
56
|
+
## Pull requests
|
57
|
+
|
58
|
+
**We will not accept pull requests that modify the SCSS beyond fixing bugs caused by *our* code!**
|
59
|
+
|
60
|
+
Most pull requests should go to [twbs/bootstrap](https://github.com/twbs/bootstrap) or [jlong/sass-twitter-bootstrap](https://github.com/jlong/sass-twitter-bootstrap)
|
61
|
+
|
62
|
+
Good pull requests - patches, improvements, new features - are a fantastic
|
63
|
+
help. They should remain focused in scope and avoid containing unrelated
|
64
|
+
commits. If your contribution involves a significant amount of work or substantial
|
65
|
+
changes to any part of the project, please open an issue to discuss it first.
|
66
|
+
|
67
|
+
Make sure to adhere to the coding conventions used throughout a project
|
68
|
+
(indentation, accurate comments, etc.). Please update any documentation that is
|
69
|
+
relevant to the change you're making.
|
70
|
+
|
71
|
+
## Do not…
|
72
|
+
|
73
|
+
Please **do not** use the issue tracker for personal support requests (use
|
74
|
+
[Stack Overflow](http://stackoverflow.com/)).
|
75
|
+
|
76
|
+
Please **do not** derail or troll issues. Keep the
|
77
|
+
discussion on topic and respect the opinions of others.
|
78
|
+
|
79
|
+
*props [html5-boilerplate](https://github.com/h5bp/html5-boilerplate/blob/master/CONTRIBUTING.md)*
|
data/Gemfile
ADDED
data/LICENSE
ADDED
@@ -0,0 +1,21 @@
|
|
1
|
+
The MIT License (MIT)
|
2
|
+
|
3
|
+
Copyright (c) 2013 Twitter, Inc
|
4
|
+
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
7
|
+
in the Software without restriction, including without limitation the rights
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
10
|
+
furnished to do so, subject to the following conditions:
|
11
|
+
|
12
|
+
The above copyright notice and this permission notice shall be included in
|
13
|
+
all copies or substantial portions of the Software.
|
14
|
+
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
21
|
+
THE SOFTWARE.
|
data/README.md
ADDED
@@ -0,0 +1,320 @@
|
|
1
|
+
# 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)
|
2
|
+
|
3
|
+
`bootstrap-sass` is a Sass-powered version of [Bootstrap](http://github.com/twbs/bootstrap), ready to drop right into your Sass powered applications.
|
4
|
+
|
5
|
+
## Installation
|
6
|
+
|
7
|
+
Please see the appropriate guide for your environment of choice:
|
8
|
+
|
9
|
+
* [Ruby on Rails](#a-ruby-on-rails).
|
10
|
+
* [Compass](#b-compass-without-rails) not on Rails.
|
11
|
+
* [Bower](#c-bower).
|
12
|
+
|
13
|
+
### a. Ruby on Rails
|
14
|
+
|
15
|
+
`bootstrap-sass` is easy to drop into Rails with the asset pipeline.
|
16
|
+
|
17
|
+
In 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.
|
18
|
+
|
19
|
+
```ruby
|
20
|
+
gem 'bootstrap-sass', '~> 3.2.0'
|
21
|
+
gem 'sass-rails', '>= 3.2'
|
22
|
+
```
|
23
|
+
|
24
|
+
It is also recommended to use [Autoprefixer](https://github.com/ai/autoprefixer-rails) with Bootstrap
|
25
|
+
to add browser vendor prefixes automatically. Simply add the gem:
|
26
|
+
|
27
|
+
```ruby
|
28
|
+
gem 'autoprefixer-rails'
|
29
|
+
```
|
30
|
+
|
31
|
+
`bundle install` and restart your server to make the files available through the pipeline.
|
32
|
+
|
33
|
+
Import Bootstrap styles in `app/assets/stylesheets/application.css.scss`:
|
34
|
+
|
35
|
+
```scss
|
36
|
+
@import "bootstrap-sprockets";
|
37
|
+
@import "bootstrap";
|
38
|
+
```
|
39
|
+
|
40
|
+
`bootstrap-sprockets` must be imported before `bootstrap` for the icon fonts to work.
|
41
|
+
|
42
|
+
Make sure the file has `.css.scss` extension (or `.css.sass` for Sass syntax). If you have just generated a new Rails app,
|
43
|
+
it may come with a `.css` file instead. If this file exists, it will be served instead of Sass, so remove it:
|
44
|
+
|
45
|
+
```console
|
46
|
+
$ rm app/assets/stylesheets/application.css
|
47
|
+
```
|
48
|
+
|
49
|
+
Do not use `//= require` in Sass or your other stylesheets will not be [able to access][antirequire] the Bootstrap mixins or variables.
|
50
|
+
|
51
|
+
Require Bootstrap Javascripts in `app/assets/javascripts/application.js`:
|
52
|
+
|
53
|
+
```js
|
54
|
+
//= require jquery
|
55
|
+
//= require bootstrap-sprockets
|
56
|
+
```
|
57
|
+
|
58
|
+
#### Bower with Rails
|
59
|
+
|
60
|
+
When using [bootstrap-sass Bower package](#c-bower) in Rails, ensure [minimum Sass number precision](#sass-number-precision):
|
61
|
+
|
62
|
+
```ruby
|
63
|
+
# e.g. config/initializers/sass.rb
|
64
|
+
::Sass::Script::Number.precision = [10, ::Sass::Script::Number.precision].max
|
65
|
+
```
|
66
|
+
|
67
|
+
#### Rails 3.2.x
|
68
|
+
|
69
|
+
Rails 3.2 is [no longer maintained for bugfixes](http://guides.rubyonrails.org/maintenance_policy.html), and you should upgrade as soon as possible.
|
70
|
+
|
71
|
+
Starting with bootstrap-sass v3.1.1.1, due to the structural changes from upstream you will need these
|
72
|
+
backported asset pipeline gems on Rails 3.2. There is more on why this is necessary in
|
73
|
+
https://github.com/twbs/bootstrap-sass/issues/523 and https://github.com/twbs/bootstrap-sass/issues/578.
|
74
|
+
|
75
|
+
```ruby
|
76
|
+
gem 'sprockets-rails', '=2.0.0.backport1'
|
77
|
+
gem 'sprockets', '=2.2.2.backport2'
|
78
|
+
gem 'sass-rails', github: 'guilleiguaran/sass-rails', branch: 'backport'
|
79
|
+
```
|
80
|
+
|
81
|
+
### b. Compass without Rails
|
82
|
+
|
83
|
+
Install the gem
|
84
|
+
```sh
|
85
|
+
gem install bootstrap-sass
|
86
|
+
```
|
87
|
+
|
88
|
+
If you have an existing Compass project:
|
89
|
+
|
90
|
+
```ruby
|
91
|
+
# config.rb:
|
92
|
+
require 'bootstrap-sass'
|
93
|
+
```
|
94
|
+
|
95
|
+
```console
|
96
|
+
$ bundle exec compass install bootstrap
|
97
|
+
```
|
98
|
+
|
99
|
+
If you are creating a new Compass project, you can generate it with bootstrap-sass support:
|
100
|
+
|
101
|
+
```console
|
102
|
+
$ bundle exec compass create my-new-project -r bootstrap-sass --using bootstrap
|
103
|
+
```
|
104
|
+
|
105
|
+
or, alternatively, if you're not using a Gemfile for your dependencies:
|
106
|
+
|
107
|
+
```console
|
108
|
+
$ compass create my-new-project -r bootstrap-sass --using bootstrap
|
109
|
+
```
|
110
|
+
|
111
|
+
This will create a new Compass project with the following files in it:
|
112
|
+
|
113
|
+
* [styles.sass](/templates/project/styles.sass) - main project Sass file, imports Bootstrap and variables.
|
114
|
+
* [_bootstrap-variables.sass](/templates/project/_bootstrap-variables.sass.erb) - all of Bootstrap variables, override them here.
|
115
|
+
|
116
|
+
Some bootstrap-sass mixins may conflict with the Compass ones.
|
117
|
+
If this happens, change the import order so that Compass mixins are loaded later.
|
118
|
+
|
119
|
+
### c. Bower
|
120
|
+
|
121
|
+
Using bootstrap-sass as a Bower package is still being tested. It is compatible with node-sass 0.8.3+. You can install it with:
|
122
|
+
|
123
|
+
```console
|
124
|
+
$ bower install bootstrap-sass-official
|
125
|
+
```
|
126
|
+
|
127
|
+
`bootstrap-sass` is taken so make sure you use the command above.
|
128
|
+
|
129
|
+
Sass, JS, and all other assets are located at [assets](/assets).
|
130
|
+
|
131
|
+
By default, `bower.json` main field list only the main `bootstrap.scss` and all the static assets (fonts and JS).
|
132
|
+
This is compatible by default with asset managers such as [wiredep](https://github.com/taptapship/wiredep).
|
133
|
+
|
134
|
+
#### Node.js Mincer
|
135
|
+
|
136
|
+
If you use [mincer][mincer] with node-sass, import bootstrap into like so:
|
137
|
+
|
138
|
+
In `application.css.ejs.scss` (NB **.css.ejs.css**):
|
139
|
+
|
140
|
+
```scss
|
141
|
+
// Import mincer asset paths helper integration
|
142
|
+
@import "bootstrap-mincer";
|
143
|
+
@import "bootstrap";
|
144
|
+
```
|
145
|
+
|
146
|
+
In `application.js`:
|
147
|
+
|
148
|
+
```js
|
149
|
+
//= require bootstrap-sprockets
|
150
|
+
```
|
151
|
+
|
152
|
+
See also this [example manifest.js](/test/dummy_node_mincer/manifest.js) for mincer.
|
153
|
+
|
154
|
+
|
155
|
+
### Configuration
|
156
|
+
|
157
|
+
#### Sass
|
158
|
+
|
159
|
+
By default all of Bootstrap is imported.
|
160
|
+
|
161
|
+
You can also import components explicitly. To start with a full list of modules copy
|
162
|
+
[`bootstrap.scss`](assets/stylesheets/_bootstrap.scss) file into your assets as `bootstrap-custom.scss`.
|
163
|
+
Then comment out components you do not want from `bootstrap-custom`.
|
164
|
+
In the application Sass file, replace `@import 'bootstrap'` with:
|
165
|
+
|
166
|
+
```scss
|
167
|
+
@import 'bootstrap-custom';
|
168
|
+
```
|
169
|
+
|
170
|
+
#### Sass: Number Precision
|
171
|
+
|
172
|
+
bootstrap-sass [requires](https://github.com/twbs/bootstrap-sass/issues/409) minimum [Sass number precision][sass-precision] of 10 (default is 5).
|
173
|
+
|
174
|
+
Precision is set for Rails and Compass automatically.
|
175
|
+
When using ruby Sass compiler standalone or with the Bower version you can set it with:
|
176
|
+
|
177
|
+
```ruby
|
178
|
+
::Sass::Script::Number.precision = [10, ::Sass::Script::Number.precision].max
|
179
|
+
```
|
180
|
+
|
181
|
+
Note 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.
|
182
|
+
|
183
|
+
|
184
|
+
#### Sass: Autoprefixer
|
185
|
+
|
186
|
+
Using [Autoprefixer][autoprefixer] with Bootstrap is recommended.
|
187
|
+
[Autoprefixer][autoprefixer] adds vendor prefixes to CSS rules using values from [Can I Use](http://caniuse.com/).
|
188
|
+
|
189
|
+
#### JavaScript
|
190
|
+
|
191
|
+
[`assets/javascripts/bootstrap.js`](/assets/javascripts/bootstrap.js) contains all of Bootstrap JavaScript,
|
192
|
+
concatenated in the [correct order](/assets/javascripts/bootstrap-sprockets.js).
|
193
|
+
|
194
|
+
|
195
|
+
#### JavaScript with Sprockets or Mincer
|
196
|
+
|
197
|
+
If you use Sprockets or Mincer, you can require `bootstrap-sprockets` instead to load the individual modules:
|
198
|
+
|
199
|
+
```js
|
200
|
+
// Load all Bootstrap JavaScript
|
201
|
+
//= require bootstrap-sprockets
|
202
|
+
```
|
203
|
+
|
204
|
+
You can also load individual modules, provided you also require any dependencies.
|
205
|
+
You can check dependencies in the [Bootstrap JS documentation][jsdocs].
|
206
|
+
|
207
|
+
```js
|
208
|
+
//= require bootstrap/scrollspy
|
209
|
+
//= require bootstrap/modal
|
210
|
+
//= require bootstrap/dropdown
|
211
|
+
```
|
212
|
+
|
213
|
+
#### Fonts
|
214
|
+
|
215
|
+
The fonts are referenced as:
|
216
|
+
|
217
|
+
```scss
|
218
|
+
"#{$icon-font-path}#{$icon-font-name}.eot"
|
219
|
+
```
|
220
|
+
|
221
|
+
`$icon-font-path` defaults to `bootstrap/` if asset path helpers are used, and `../fonts/bootstrap/` otherwise.
|
222
|
+
|
223
|
+
When using bootstrap-sass with Compass, Sprockets, or Mincer, you **must** import the relevant path helpers before Bootstrap itself, for example:
|
224
|
+
|
225
|
+
```scss
|
226
|
+
@import "bootstrap-compass";
|
227
|
+
@import "bootstrap";
|
228
|
+
```
|
229
|
+
|
230
|
+
## Usage
|
231
|
+
|
232
|
+
### Sass
|
233
|
+
|
234
|
+
Import Bootstrap into a Sass file (for example, application.css.scss) to get all of Bootstrap's styles, mixins and variables!
|
235
|
+
|
236
|
+
```scss
|
237
|
+
@import "bootstrap";
|
238
|
+
```
|
239
|
+
|
240
|
+
You can also include optional bootstrap theme:
|
241
|
+
|
242
|
+
```scss
|
243
|
+
@import "bootstrap/theme";
|
244
|
+
```
|
245
|
+
|
246
|
+
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, e.g.:
|
247
|
+
|
248
|
+
```scss
|
249
|
+
$navbar-default-bg: #312312;
|
250
|
+
$light-orange: #ff8c00;
|
251
|
+
$navbar-default-color: $light-orange;
|
252
|
+
|
253
|
+
@import "bootstrap";
|
254
|
+
```
|
255
|
+
|
256
|
+
## Version
|
257
|
+
|
258
|
+
`bootstrap-sass` version reflects the upstream version, with an additional number for Sass-specific changes.
|
259
|
+
|
260
|
+
Always refer to [CHANGELOG.md](/CHANGELOG.md) when upgrading.
|
261
|
+
|
262
|
+
---
|
263
|
+
|
264
|
+
## Development and Contributing
|
265
|
+
|
266
|
+
If you'd like to help with the development of bootstrap-sass itself, read this section.
|
267
|
+
|
268
|
+
### Upstream Converter
|
269
|
+
|
270
|
+
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.
|
271
|
+
|
272
|
+
**Note: if you're just looking to *use* Bootstrap 3, see the [installation](#installation) section above.**
|
273
|
+
|
274
|
+
Upstream changes to the Bootstrap project can now be pulled in using the `convert` rake task.
|
275
|
+
|
276
|
+
Here's an example run that would pull down the master branch from the main [twbs/bootstrap](https://github.com/twbs/bootstrap) repo:
|
277
|
+
|
278
|
+
rake convert
|
279
|
+
|
280
|
+
This will convert the latest LESS to Sass and update to the latest JS.
|
281
|
+
To convert a specific branch or version, pass the branch name or the commit hash as the first task argument:
|
282
|
+
|
283
|
+
rake convert[e8a1df5f060bf7e6631554648e0abde150aedbe4]
|
284
|
+
|
285
|
+
The latest converter script is located [here][converter] and does the following:
|
286
|
+
|
287
|
+
* Converts upstream bootstrap LESS files to its matching SCSS file.
|
288
|
+
* 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`.
|
289
|
+
* Copies all upstream font files into `assets/fonts/bootstrap`.
|
290
|
+
* Sets `Bootstrap::BOOTSTRAP_SHA` in [version.rb][version] to the branch sha.
|
291
|
+
|
292
|
+
This converter fully converts original LESS to SCSS. Conversion is automatic but requires instructions for certain transformations (see converter output).
|
293
|
+
Please submit GitHub issues tagged with `conversion`.
|
294
|
+
|
295
|
+
## Credits
|
296
|
+
|
297
|
+
bootstrap-sass has a number of major contributors:
|
298
|
+
|
299
|
+
<!-- feel free to make these link wherever you wish -->
|
300
|
+
* [Thomas McDonald](https://twitter.com/thomasmcdonald_)
|
301
|
+
* [Tristan Harward](http://www.trisweb.com)
|
302
|
+
* Peter Gumeson
|
303
|
+
* [Gleb Mazovetskiy](https://github.com/glebm)
|
304
|
+
|
305
|
+
and a [significant number of other contributors][contrib].
|
306
|
+
|
307
|
+
## You're in good company
|
308
|
+
bootstrap-sass is used to build some awesome projects all over the web, including
|
309
|
+
[Diaspora](http://diasporaproject.org/), [rails_admin](https://github.com/sferik/rails_admin),
|
310
|
+
Michael Hartl's [Rails Tutorial](http://railstutorial.org/), [gitlabhq](http://gitlabhq.com/) and
|
311
|
+
[kandan](http://kandanapp.com/).
|
312
|
+
|
313
|
+
[converter]: https://github.com/twbs/bootstrap-sass/blob/master/tasks/converter/less_conversion.rb
|
314
|
+
[version]: https://github.com/twbs/bootstrap-sass/blob/master/lib/bootstrap-sass/version.rb
|
315
|
+
[contrib]: https://github.com/twbs/bootstrap-sass/graphs/contributors
|
316
|
+
[antirequire]: https://github.com/twbs/bootstrap-sass/issues/79#issuecomment-4428595
|
317
|
+
[jsdocs]: http://getbootstrap.com/javascript/#transitions
|
318
|
+
[sass-precision]: http://sass-lang.com/documentation/Sass/Script/Number.html#precision-class_method
|
319
|
+
[mincer]: https://github.com/nodeca/mincer
|
320
|
+
[autoprefixer]: https://github.com/ai/autoprefixer
|