bootstrap-sass-backport 3.2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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