bootstrap-sass-backport 3.2.0.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (180) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +19 -0
  3. data/.travis.yml +19 -0
  4. data/CHANGELOG.md +146 -0
  5. data/CONTRIBUTING.md +79 -0
  6. data/Gemfile +10 -0
  7. data/LICENSE +21 -0
  8. data/README.md +320 -0
  9. data/Rakefile +54 -0
  10. data/assets/fonts/bootstrap/glyphicons-halflings-regular.eot +0 -0
  11. data/assets/fonts/bootstrap/glyphicons-halflings-regular.svg +229 -0
  12. data/assets/fonts/bootstrap/glyphicons-halflings-regular.ttf +0 -0
  13. data/assets/fonts/bootstrap/glyphicons-halflings-regular.woff +0 -0
  14. data/assets/images/.keep +0 -0
  15. data/assets/javascripts/bootstrap-sprockets.js +12 -0
  16. data/assets/javascripts/bootstrap.js +2107 -0
  17. data/assets/javascripts/bootstrap/affix.js +142 -0
  18. data/assets/javascripts/bootstrap/alert.js +92 -0
  19. data/assets/javascripts/bootstrap/button.js +110 -0
  20. data/assets/javascripts/bootstrap/carousel.js +223 -0
  21. data/assets/javascripts/bootstrap/collapse.js +170 -0
  22. data/assets/javascripts/bootstrap/dropdown.js +151 -0
  23. data/assets/javascripts/bootstrap/modal.js +280 -0
  24. data/assets/javascripts/bootstrap/popover.js +113 -0
  25. data/assets/javascripts/bootstrap/scrollspy.js +170 -0
  26. data/assets/javascripts/bootstrap/tab.js +128 -0
  27. data/assets/javascripts/bootstrap/tooltip.js +457 -0
  28. data/assets/javascripts/bootstrap/transition.js +59 -0
  29. data/assets/stylesheets/_bootstrap-compass.scss +7 -0
  30. data/assets/stylesheets/_bootstrap-mincer.scss +17 -0
  31. data/assets/stylesheets/_bootstrap-sprockets.scss +7 -0
  32. data/assets/stylesheets/_bootstrap.scss +50 -0
  33. data/assets/stylesheets/bootstrap/_alerts.scss +68 -0
  34. data/assets/stylesheets/bootstrap/_badges.scss +57 -0
  35. data/assets/stylesheets/bootstrap/_breadcrumbs.scss +26 -0
  36. data/assets/stylesheets/bootstrap/_button-groups.scss +240 -0
  37. data/assets/stylesheets/bootstrap/_buttons.scss +157 -0
  38. data/assets/stylesheets/bootstrap/_carousel.scss +243 -0
  39. data/assets/stylesheets/bootstrap/_close.scss +35 -0
  40. data/assets/stylesheets/bootstrap/_code.scss +68 -0
  41. data/assets/stylesheets/bootstrap/_component-animations.scss +35 -0
  42. data/assets/stylesheets/bootstrap/_dropdowns.scss +215 -0
  43. data/assets/stylesheets/bootstrap/_forms.scss +538 -0
  44. data/assets/stylesheets/bootstrap/_glyphicons.scss +237 -0
  45. data/assets/stylesheets/bootstrap/_grid.scss +84 -0
  46. data/assets/stylesheets/bootstrap/_input-groups.scss +166 -0
  47. data/assets/stylesheets/bootstrap/_jumbotron.scss +48 -0
  48. data/assets/stylesheets/bootstrap/_labels.scss +66 -0
  49. data/assets/stylesheets/bootstrap/_list-group.scss +131 -0
  50. data/assets/stylesheets/bootstrap/_media.scss +56 -0
  51. data/assets/stylesheets/bootstrap/_mixins.scss +39 -0
  52. data/assets/stylesheets/bootstrap/_modals.scss +150 -0
  53. data/assets/stylesheets/bootstrap/_navbar.scss +659 -0
  54. data/assets/stylesheets/bootstrap/_navs.scss +242 -0
  55. data/assets/stylesheets/bootstrap/_normalize.scss +425 -0
  56. data/assets/stylesheets/bootstrap/_pager.scss +55 -0
  57. data/assets/stylesheets/bootstrap/_pagination.scss +88 -0
  58. data/assets/stylesheets/bootstrap/_panels.scss +243 -0
  59. data/assets/stylesheets/bootstrap/_popovers.scss +133 -0
  60. data/assets/stylesheets/bootstrap/_print.scss +101 -0
  61. data/assets/stylesheets/bootstrap/_progress-bars.scss +105 -0
  62. data/assets/stylesheets/bootstrap/_responsive-embed.scss +34 -0
  63. data/assets/stylesheets/bootstrap/_responsive-utilities.scss +174 -0
  64. data/assets/stylesheets/bootstrap/_scaffolding.scss +150 -0
  65. data/assets/stylesheets/bootstrap/_tables.scss +233 -0
  66. data/assets/stylesheets/bootstrap/_theme.scss +258 -0
  67. data/assets/stylesheets/bootstrap/_thumbnails.scss +38 -0
  68. data/assets/stylesheets/bootstrap/_tooltip.scss +95 -0
  69. data/assets/stylesheets/bootstrap/_type.scss +304 -0
  70. data/assets/stylesheets/bootstrap/_utilities.scss +57 -0
  71. data/assets/stylesheets/bootstrap/_variables.scss +854 -0
  72. data/assets/stylesheets/bootstrap/_wells.scss +29 -0
  73. data/assets/stylesheets/bootstrap/mixins/_alerts.scss +14 -0
  74. data/assets/stylesheets/bootstrap/mixins/_background-variant.scss +11 -0
  75. data/assets/stylesheets/bootstrap/mixins/_border-radius.scss +18 -0
  76. data/assets/stylesheets/bootstrap/mixins/_buttons.scss +50 -0
  77. data/assets/stylesheets/bootstrap/mixins/_center-block.scss +7 -0
  78. data/assets/stylesheets/bootstrap/mixins/_clearfix.scss +22 -0
  79. data/assets/stylesheets/bootstrap/mixins/_forms.scss +84 -0
  80. data/assets/stylesheets/bootstrap/mixins/_gradients.scss +58 -0
  81. data/assets/stylesheets/bootstrap/mixins/_grid-framework.scss +81 -0
  82. data/assets/stylesheets/bootstrap/mixins/_grid.scss +122 -0
  83. data/assets/stylesheets/bootstrap/mixins/_hide-text.scss +21 -0
  84. data/assets/stylesheets/bootstrap/mixins/_image.scss +34 -0
  85. data/assets/stylesheets/bootstrap/mixins/_labels.scss +12 -0
  86. data/assets/stylesheets/bootstrap/mixins/_list-group.scss +31 -0
  87. data/assets/stylesheets/bootstrap/mixins/_nav-divider.scss +10 -0
  88. data/assets/stylesheets/bootstrap/mixins/_nav-vertical-align.scss +9 -0
  89. data/assets/stylesheets/bootstrap/mixins/_opacity.scss +8 -0
  90. data/assets/stylesheets/bootstrap/mixins/_pagination.scss +23 -0
  91. data/assets/stylesheets/bootstrap/mixins/_panels.scss +24 -0
  92. data/assets/stylesheets/bootstrap/mixins/_progress-bar.scss +10 -0
  93. data/assets/stylesheets/bootstrap/mixins/_reset-filter.scss +8 -0
  94. data/assets/stylesheets/bootstrap/mixins/_resize.scss +6 -0
  95. data/assets/stylesheets/bootstrap/mixins/_responsive-visibility.scss +21 -0
  96. data/assets/stylesheets/bootstrap/mixins/_size.scss +10 -0
  97. data/assets/stylesheets/bootstrap/mixins/_tab-focus.scss +9 -0
  98. data/assets/stylesheets/bootstrap/mixins/_table-row.scss +28 -0
  99. data/assets/stylesheets/bootstrap/mixins/_text-emphasis.scss +11 -0
  100. data/assets/stylesheets/bootstrap/mixins/_text-overflow.scss +8 -0
  101. data/assets/stylesheets/bootstrap/mixins/_vendor-prefixes.scss +219 -0
  102. data/bootstrap-sass-backport.gemspec +36 -0
  103. data/bower.json +50 -0
  104. data/composer.json +35 -0
  105. data/lib/bootstrap-sass-backport.rb +71 -0
  106. data/lib/bootstrap-sass/engine.rb +12 -0
  107. data/lib/bootstrap-sass/version.rb +4 -0
  108. data/package.json +30 -0
  109. data/sache.json +5 -0
  110. data/tasks/bower.rake +34 -0
  111. data/tasks/converter.rb +80 -0
  112. data/tasks/converter/char_string_scanner.rb +38 -0
  113. data/tasks/converter/fonts_conversion.rb +16 -0
  114. data/tasks/converter/js_conversion.rb +45 -0
  115. data/tasks/converter/less_conversion.rb +670 -0
  116. data/tasks/converter/logger.rb +57 -0
  117. data/tasks/converter/network.rb +86 -0
  118. data/templates/project/_bootstrap-variables.sass.erb +4 -0
  119. data/templates/project/manifest.rb +26 -0
  120. data/templates/project/styles.sass +3 -0
  121. data/test/compass_test.rb +9 -0
  122. data/test/compilation_test.rb +18 -0
  123. data/test/dummy_node_mincer/apple-touch-icon-144-precomposed.png +0 -0
  124. data/test/dummy_node_mincer/application.css.ejs.scss +6 -0
  125. data/test/dummy_node_mincer/manifest.js +87 -0
  126. data/test/dummy_rails/README.rdoc +3 -0
  127. data/test/dummy_rails/Rakefile +6 -0
  128. data/test/dummy_rails/app/assets/images/.keep +0 -0
  129. data/test/dummy_rails/app/assets/javascripts/application.js +2 -0
  130. data/test/dummy_rails/app/assets/stylesheets/application.css.sass +2 -0
  131. data/test/dummy_rails/app/controllers/application_controller.rb +5 -0
  132. data/test/dummy_rails/app/controllers/pages_controller.rb +4 -0
  133. data/test/dummy_rails/app/helpers/application_helper.rb +2 -0
  134. data/test/dummy_rails/app/views/layouts/application.html.erb +14 -0
  135. data/test/dummy_rails/app/views/pages/root.html.slim +41 -0
  136. data/test/dummy_rails/bin/bundle +3 -0
  137. data/test/dummy_rails/bin/rails +4 -0
  138. data/test/dummy_rails/bin/rake +4 -0
  139. data/test/dummy_rails/config.ru +4 -0
  140. data/test/dummy_rails/config/application.rb +30 -0
  141. data/test/dummy_rails/config/boot.rb +5 -0
  142. data/test/dummy_rails/config/environment.rb +5 -0
  143. data/test/dummy_rails/config/environments/development.rb +26 -0
  144. data/test/dummy_rails/config/environments/production.rb +76 -0
  145. data/test/dummy_rails/config/environments/test.rb +30 -0
  146. data/test/dummy_rails/config/initializers/backtrace_silencers.rb +7 -0
  147. data/test/dummy_rails/config/initializers/filter_parameter_logging.rb +4 -0
  148. data/test/dummy_rails/config/initializers/inflections.rb +16 -0
  149. data/test/dummy_rails/config/initializers/mime_types.rb +5 -0
  150. data/test/dummy_rails/config/initializers/secret_token.rb +18 -0
  151. data/test/dummy_rails/config/initializers/session_store.rb +3 -0
  152. data/test/dummy_rails/config/initializers/wrap_parameters.rb +14 -0
  153. data/test/dummy_rails/config/locales/en.yml +3 -0
  154. data/test/dummy_rails/config/locales/es.yml +3 -0
  155. data/test/dummy_rails/config/routes.rb +3 -0
  156. data/test/dummy_rails/db/test.sqlite3 +0 -0
  157. data/test/dummy_rails/lib/assets/.keep +0 -0
  158. data/test/dummy_rails/log/.keep +0 -0
  159. data/test/dummy_rails/public/404.html +58 -0
  160. data/test/dummy_rails/public/422.html +58 -0
  161. data/test/dummy_rails/public/500.html +57 -0
  162. data/test/dummy_rails/public/favicon.ico +0 -0
  163. data/test/dummy_sass_only/Gemfile +4 -0
  164. data/test/dummy_sass_only/compile.rb +13 -0
  165. data/test/dummy_sass_only/import_all.sass +2 -0
  166. data/test/gemfiles/sass_3_2.gemfile +6 -0
  167. data/test/gemfiles/sass_3_3.gemfile +6 -0
  168. data/test/gemfiles/sass_3_4.gemfile +7 -0
  169. data/test/gemfiles/sass_head.gemfile +6 -0
  170. data/test/node_mincer_test.rb +36 -0
  171. data/test/node_sass_test.rb +16 -0
  172. data/test/pages_test.rb +14 -0
  173. data/test/sass_test.rb +26 -0
  174. data/test/sprockets_rails_test.rb +27 -0
  175. data/test/support/dummy_rails_integration.rb +22 -0
  176. data/test/support/integration_test.rb +22 -0
  177. data/test/support/reporting.rb +17 -0
  178. data/test/test_helper.rb +35 -0
  179. data/test/test_helper_rails.rb +6 -0
  180. metadata +484 -0
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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?** &mdash; 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** &mdash; check if the issue has already been
24
+ reported.
25
+
26
+ 3. **Isolate the problem** &mdash; 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
@@ -0,0 +1,10 @@
1
+ source 'https://rubygems.org'
2
+
3
+ gemspec
4
+
5
+ # Compass for the dummy app
6
+ gem 'compass', require: false
7
+
8
+ group :development do
9
+ gem 'byebug', platform: :mri_21, require: false
10
+ end
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.
@@ -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