bourbon 3.2.4 → 4.0.0.rc1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (78) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +6 -6
  3. data/.npmignore +9 -11
  4. data/Gemfile.lock +49 -0
  5. data/{LICENSE.md → LICENSE} +10 -8
  6. data/app/assets/stylesheets/_bourbon-deprecated-upcoming.scss +3 -8
  7. data/app/assets/stylesheets/_bourbon.scss +9 -12
  8. data/app/assets/stylesheets/addons/_directional-values.scss +8 -5
  9. data/app/assets/stylesheets/addons/_html5-input-types.scss +15 -39
  10. data/app/assets/stylesheets/addons/_position.scss +5 -5
  11. data/app/assets/stylesheets/addons/_prefixer.scss +5 -5
  12. data/app/assets/stylesheets/addons/_rem.scss +33 -0
  13. data/app/assets/stylesheets/addons/_retina-image.scss +1 -1
  14. data/app/assets/stylesheets/addons/_size.scss +9 -37
  15. data/app/assets/stylesheets/addons/_timing-functions.scss +1 -1
  16. data/app/assets/stylesheets/addons/_triangle.scss +0 -1
  17. data/app/assets/stylesheets/css3/_background-image.scss +29 -35
  18. data/app/assets/stylesheets/css3/_background.scss +37 -85
  19. data/app/assets/stylesheets/css3/_border-image.scss +45 -42
  20. data/app/assets/stylesheets/css3/_flex-box.scss +14 -14
  21. data/app/assets/stylesheets/css3/_font-face.scss +1 -1
  22. data/app/assets/stylesheets/css3/_keyframes.scss +7 -7
  23. data/app/assets/stylesheets/functions/_assign.scss +11 -0
  24. data/app/assets/stylesheets/functions/_color-lightness.scss +5 -5
  25. data/app/assets/stylesheets/helpers/_convert-units.scss +15 -0
  26. data/app/assets/stylesheets/helpers/_is-num.scss +8 -0
  27. data/app/assets/stylesheets/helpers/_linear-angle-parser.scss +25 -0
  28. data/app/assets/stylesheets/helpers/_linear-gradient-parser.scss +41 -0
  29. data/app/assets/stylesheets/helpers/_linear-side-corner-parser.scss +31 -0
  30. data/app/assets/stylesheets/helpers/_radial-gradient-parser.scss +50 -0
  31. data/app/assets/stylesheets/helpers/_render-gradients.scss +2 -2
  32. data/app/assets/stylesheets/helpers/_str-to-num.scss +50 -0
  33. data/bourbon.gemspec +2 -2
  34. data/bower.json +6 -23
  35. data/dist/_bourbon-deprecated-upcoming.scss +3 -8
  36. data/dist/_bourbon.scss +9 -12
  37. data/dist/addons/_directional-values.scss +8 -5
  38. data/dist/addons/_html5-input-types.scss +15 -39
  39. data/dist/addons/_position.scss +5 -5
  40. data/dist/addons/_prefixer.scss +5 -5
  41. data/dist/addons/_rem.scss +33 -0
  42. data/dist/addons/_retina-image.scss +1 -1
  43. data/dist/addons/_size.scss +9 -37
  44. data/dist/addons/_timing-functions.scss +1 -1
  45. data/dist/addons/_triangle.scss +0 -1
  46. data/dist/css3/_background-image.scss +29 -35
  47. data/dist/css3/_background.scss +37 -85
  48. data/dist/css3/_border-image.scss +45 -42
  49. data/dist/css3/_flex-box.scss +14 -14
  50. data/dist/css3/_font-face.scss +1 -1
  51. data/dist/css3/_keyframes.scss +7 -7
  52. data/dist/functions/_assign.scss +11 -0
  53. data/dist/functions/_color-lightness.scss +5 -5
  54. data/dist/helpers/_convert-units.scss +15 -0
  55. data/dist/helpers/_is-num.scss +8 -0
  56. data/dist/helpers/_linear-angle-parser.scss +25 -0
  57. data/dist/helpers/_linear-gradient-parser.scss +41 -0
  58. data/dist/helpers/_linear-side-corner-parser.scss +31 -0
  59. data/dist/helpers/_radial-gradient-parser.scss +50 -0
  60. data/dist/helpers/_render-gradients.scss +2 -2
  61. data/dist/helpers/_str-to-num.scss +50 -0
  62. data/lib/bourbon/version.rb +1 -1
  63. data/package.json +14 -18
  64. data/readme.md +96 -0
  65. metadata +38 -33
  66. data/README.md +0 -126
  67. data/app/assets/stylesheets/addons/_word-wrap.scss +0 -8
  68. data/app/assets/stylesheets/css3/_inline-block.scss +0 -8
  69. data/app/assets/stylesheets/functions/_linear-gradient.scss +0 -13
  70. data/app/assets/stylesheets/functions/_px-to-rem.scss +0 -15
  71. data/app/assets/stylesheets/functions/_radial-gradient.scss +0 -23
  72. data/app/assets/stylesheets/settings/_asset-pipeline.scss +0 -1
  73. data/dist/addons/_word-wrap.scss +0 -8
  74. data/dist/css3/_inline-block.scss +0 -8
  75. data/dist/functions/_linear-gradient.scss +0 -13
  76. data/dist/functions/_px-to-rem.scss +0 -15
  77. data/dist/functions/_radial-gradient.scss +0 -23
  78. data/dist/settings/_asset-pipeline.scss +0 -1
@@ -0,0 +1,50 @@
1
+ //************************************************************************//
2
+ // Helper function for linear/radial-gradient-parsers.
3
+ // Source: http://sassmeister.com/gist/9647408
4
+ //************************************************************************//
5
+ @function _str-to-num($string) {
6
+ // Matrices
7
+ $strings: '0' '1' '2' '3' '4' '5' '6' '7' '8' '9';
8
+ $numbers: 0 1 2 3 4 5 6 7 8 9;
9
+
10
+ // Result
11
+ $result: 0;
12
+ $divider: 0;
13
+ $minus: false;
14
+
15
+ // Looping through all characters
16
+ @for $i from 1 through str-length($string) {
17
+ $character: str-slice($string, $i, $i);
18
+ $index: index($strings, $character);
19
+
20
+ @if $character == '-' {
21
+ $minus: true;
22
+ }
23
+
24
+ @else if $character == '.' {
25
+ $divider: 1;
26
+ }
27
+
28
+ @else {
29
+ @if not $index {
30
+ $result: if($minus, $result * -1, $result);
31
+ @return _convert-units($result, str-slice($string, $i));
32
+ }
33
+
34
+ $number: nth($numbers, $index);
35
+
36
+ @if $divider == 0 {
37
+ $result: $result * 10;
38
+ }
39
+
40
+ @else {
41
+ // Move the decimal dot to the left
42
+ $divider: $divider * 10;
43
+ $number: $number / $divider;
44
+ }
45
+
46
+ $result: $result + $number;
47
+ }
48
+ }
49
+ @return if($minus, $result * -1, $result);
50
+ }
@@ -1,3 +1,3 @@
1
1
  module Bourbon
2
- VERSION = "3.2.4"
2
+ VERSION = "4.0.0.rc1"
3
3
  end
@@ -1,28 +1,24 @@
1
1
  {
2
2
  "name": "bourbon",
3
- "version": "3.2.4",
3
+ "version": "3.2.0-beta.2",
4
4
  "description": "A simple and lightweight mixin library for Sass.",
5
+ "main": "dist/_bourbon.scss",
6
+ "scripts": {
7
+ "test": "echo \"Error: no test specified\" && exit 1"
8
+ },
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "https://github.com/thoughtbot/bourbon"
12
+ },
5
13
  "keywords": [
14
+ "scss",
6
15
  "css",
7
- "mixins",
8
- "sass",
9
- "scss"
16
+ "mixins"
10
17
  ],
11
- "homepage": "http://bourbon.io",
18
+ "author": "Thoughtbot",
19
+ "license": "MIT",
12
20
  "bugs": {
13
21
  "url": "https://github.com/thoughtbot/bourbon/issues"
14
22
  },
15
- "license": "MIT",
16
- "author": {
17
- "name": "thoughtbot",
18
- "url": "http://thoughtbot.com"
19
- },
20
- "main": "dist/_bourbon.scss",
21
- "repository": {
22
- "type": "git",
23
- "url": "https://github.com/thoughtbot/bourbon.git"
24
- },
25
- "scripts": {
26
- "test": "echo \"No test specified\""
27
- }
23
+ "homepage": "https://github.com/thoughtbot/bourbon"
28
24
  }
@@ -0,0 +1,96 @@
1
+ [![Code Climate](https://codeclimate.com/github/thoughtbot/bourbon.png)](https://codeclimate.com/github/thoughtbot/bourbon)
2
+
3
+ [![Bourbon Sass Mixin Library](http://bourbon.io/images/shared/bourbon-logo.png)](http://bourbon.io)
4
+
5
+ # A simple and lightweight mixin library for Sass
6
+ Bourbon is a comprehensive library of sass mixins that are designed to be simple
7
+ and easy to use. No configuration required.
8
+ The mixins aim to be as vanilla as possible, meaning they should be as close to the original CSS syntax as possible.
9
+
10
+ The mixins contain vendor specific prefixes for all CSS3 properties for support
11
+ amongst modern browsers. The prefixes also ensure graceful degradation for older
12
+ browsers that support only CSS3 prefixed properties. Bourbon uses SCSS syntax.
13
+
14
+ ### [Documentation & Demo](http://bourbon.io)
15
+
16
+ ### Requirements
17
+ Sass 3.2+
18
+
19
+ ### Install for Rails 3.1+
20
+ In your Gemfile:
21
+
22
+ gem 'bourbon'
23
+
24
+ Then run:
25
+
26
+ $ bundle install
27
+
28
+ Restart your server. Then rename application`.css` to application`.css.scss`:
29
+
30
+ mv app/assets/stylesheets/application.css app/assets/stylesheets/application.css.scss
31
+
32
+ Delete the sprocket directive in application.css.scss: [Why?](https://github.com/thoughtbot/bourbon/wiki/Rails-Sprockets)
33
+
34
+ *= require_tree .
35
+
36
+ Import Bourbon at the beginning of application.css.scss. All additional stylesheets must be imported below Bourbon:
37
+
38
+ @import "bourbon";
39
+ @import "home";
40
+ @import "users";
41
+
42
+
43
+ [Help! I'm getting an undefined mixin error.](https://github.com/thoughtbot/bourbon/wiki/Rails-Help-%5C-Undefined-mixin)
44
+
45
+ ##### [Rails 3.0.x Install Instructions](https://github.com/thoughtbot/bourbon/wiki/Rails-3.0.x-Install) | [Rails 2.3 Install Instructions](https://github.com/thoughtbot/bourbon/wiki/Bourbon-v2.x-or-Rails-2.3-Install)
46
+
47
+ ### Non-Rails projects
48
+ Bourbon includes an easy way to generate a directory with all the necessary files.
49
+ For command line help: `$ bourbon help` or visit the [Command line tools wiki](https://github.com/thoughtbot/bourbon/wiki/Command-Line-Tools)
50
+
51
+ ##### Install (Bourbon v3.0+)
52
+
53
+ gem install bourbon
54
+
55
+ Install Bourbon into the current directory by generating the `bourbon` folder:
56
+
57
+ bourbon install
58
+
59
+ The generated folder will contain all the mixins and other necessary Bourbon files. It is recommended not to add or modify the Bourbon files so that you can update Bourbon easily.
60
+
61
+ You can specify a target directory using the `path` flag:
62
+
63
+ bourbon install --path my/custom/path/
64
+
65
+ ##### Import
66
+
67
+ Lastly, import the mixins at the beginning of your stylesheet(s):
68
+
69
+ @import 'bourbon/bourbon';
70
+
71
+ Note: Bourbon no longer requires a custom `sass --watch` command for Bourbon v3.0+
72
+
73
+ ##### Other Commands
74
+ Visit the [Command line tools wiki](https://github.com/thoughtbot/bourbon/wiki/Command-Line-Tools) for a complete list
75
+
76
+ bourbon help
77
+ bourbon update
78
+
79
+ ##### [Bourbon v2.x install instructions](https://github.com/thoughtbot/bourbon/wiki/Bourbon-v2.x-or-Rails-2.3-Install)
80
+
81
+
82
+ - [Changelog](https://github.com/thoughtbot/bourbon/wiki)
83
+ - [Browser support](https://github.com/thoughtbot/bourbon/wiki/Browser-Support)
84
+
85
+
86
+ ### Credits
87
+ ![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
88
+
89
+ Bourbon is maintained and funded by [thoughtbot, inc](http://thoughtbot.com/community)
90
+
91
+ The names and logos for thoughtbot are trademarks of thoughtbot, inc.
92
+
93
+ Got questions? Need help? Tweet at [@phillapier](http://twitter.com/phillapier).
94
+
95
+ ### License
96
+ Bourbon is Copyright © 2011-2013 thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: bourbon
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.2.4
4
+ version: 4.0.0.rc1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Phil LaPier
@@ -16,66 +16,65 @@ authors:
16
16
  - Gabe Berke-Williams
17
17
  - J. Edward Dewyea
18
18
  - Reda Lemeden
19
- - Kyle Fiedler
20
19
  autorequire:
21
20
  bindir: bin
22
21
  cert_chain: []
23
- date: 2015-01-16 00:00:00.000000000 Z
22
+ date: 2014-03-20 00:00:00.000000000 Z
24
23
  dependencies:
25
24
  - !ruby/object:Gem::Dependency
26
25
  name: sass
27
26
  requirement: !ruby/object:Gem::Requirement
28
27
  requirements:
29
- - - "~>"
28
+ - - ~>
30
29
  - !ruby/object:Gem::Version
31
- version: '3.2'
30
+ version: '3.3'
32
31
  type: :runtime
33
32
  prerelease: false
34
33
  version_requirements: !ruby/object:Gem::Requirement
35
34
  requirements:
36
- - - "~>"
35
+ - - ~>
37
36
  - !ruby/object:Gem::Version
38
- version: '3.2'
37
+ version: '3.3'
39
38
  - !ruby/object:Gem::Dependency
40
39
  name: thor
41
40
  requirement: !ruby/object:Gem::Requirement
42
41
  requirements:
43
- - - ">="
42
+ - - '>='
44
43
  - !ruby/object:Gem::Version
45
44
  version: '0'
46
45
  type: :runtime
47
46
  prerelease: false
48
47
  version_requirements: !ruby/object:Gem::Requirement
49
48
  requirements:
50
- - - ">="
49
+ - - '>='
51
50
  - !ruby/object:Gem::Version
52
51
  version: '0'
53
52
  - !ruby/object:Gem::Dependency
54
53
  name: aruba
55
54
  requirement: !ruby/object:Gem::Requirement
56
55
  requirements:
57
- - - "~>"
56
+ - - ~>
58
57
  - !ruby/object:Gem::Version
59
58
  version: '0.4'
60
59
  type: :development
61
60
  prerelease: false
62
61
  version_requirements: !ruby/object:Gem::Requirement
63
62
  requirements:
64
- - - "~>"
63
+ - - ~>
65
64
  - !ruby/object:Gem::Version
66
65
  version: '0.4'
67
66
  - !ruby/object:Gem::Dependency
68
67
  name: rake
69
68
  requirement: !ruby/object:Gem::Requirement
70
69
  requirements:
71
- - - ">="
70
+ - - '>='
72
71
  - !ruby/object:Gem::Version
73
72
  version: '0'
74
73
  type: :development
75
74
  prerelease: false
76
75
  version_requirements: !ruby/object:Gem::Requirement
77
76
  requirements:
78
- - - ">="
77
+ - - '>='
79
78
  - !ruby/object:Gem::Version
80
79
  version: '0'
81
80
  description: |
@@ -92,12 +91,11 @@ executables:
92
91
  extensions: []
93
92
  extra_rdoc_files: []
94
93
  files:
95
- - ".gitignore"
96
- - ".npmignore"
94
+ - .gitignore
95
+ - .npmignore
97
96
  - Gemfile
98
97
  - Gemfile.lock
99
- - LICENSE.md
100
- - README.md
98
+ - LICENSE
101
99
  - Rakefile
102
100
  - app/assets/stylesheets/_bourbon-deprecated-upcoming.scss
103
101
  - app/assets/stylesheets/_bourbon.scss
@@ -110,11 +108,11 @@ files:
110
108
  - app/assets/stylesheets/addons/_html5-input-types.scss
111
109
  - app/assets/stylesheets/addons/_position.scss
112
110
  - app/assets/stylesheets/addons/_prefixer.scss
111
+ - app/assets/stylesheets/addons/_rem.scss
113
112
  - app/assets/stylesheets/addons/_retina-image.scss
114
113
  - app/assets/stylesheets/addons/_size.scss
115
114
  - app/assets/stylesheets/addons/_timing-functions.scss
116
115
  - app/assets/stylesheets/addons/_triangle.scss
117
- - app/assets/stylesheets/addons/_word-wrap.scss
118
116
  - app/assets/stylesheets/css3/_animation.scss
119
117
  - app/assets/stylesheets/css3/_appearance.scss
120
118
  - app/assets/stylesheets/css3/_backface-visibility.scss
@@ -132,7 +130,6 @@ files:
132
130
  - app/assets/stylesheets/css3/_hidpi-media-query.scss
133
131
  - app/assets/stylesheets/css3/_hyphens.scss
134
132
  - app/assets/stylesheets/css3/_image-rendering.scss
135
- - app/assets/stylesheets/css3/_inline-block.scss
136
133
  - app/assets/stylesheets/css3/_keyframes.scss
137
134
  - app/assets/stylesheets/css3/_linear-gradient.scss
138
135
  - app/assets/stylesheets/css3/_perspective.scss
@@ -141,26 +138,30 @@ files:
141
138
  - app/assets/stylesheets/css3/_transform.scss
142
139
  - app/assets/stylesheets/css3/_transition.scss
143
140
  - app/assets/stylesheets/css3/_user-select.scss
141
+ - app/assets/stylesheets/functions/_assign.scss
144
142
  - app/assets/stylesheets/functions/_color-lightness.scss
145
143
  - app/assets/stylesheets/functions/_flex-grid.scss
146
144
  - app/assets/stylesheets/functions/_golden-ratio.scss
147
145
  - app/assets/stylesheets/functions/_grid-width.scss
148
- - app/assets/stylesheets/functions/_linear-gradient.scss
149
146
  - app/assets/stylesheets/functions/_modular-scale.scss
150
147
  - app/assets/stylesheets/functions/_px-to-em.scss
151
- - app/assets/stylesheets/functions/_px-to-rem.scss
152
- - app/assets/stylesheets/functions/_radial-gradient.scss
153
148
  - app/assets/stylesheets/functions/_strip-units.scss
154
149
  - app/assets/stylesheets/functions/_tint-shade.scss
155
150
  - app/assets/stylesheets/functions/_transition-property-name.scss
156
151
  - app/assets/stylesheets/functions/_unpack.scss
152
+ - app/assets/stylesheets/helpers/_convert-units.scss
157
153
  - app/assets/stylesheets/helpers/_gradient-positions-parser.scss
154
+ - app/assets/stylesheets/helpers/_is-num.scss
155
+ - app/assets/stylesheets/helpers/_linear-angle-parser.scss
156
+ - app/assets/stylesheets/helpers/_linear-gradient-parser.scss
158
157
  - app/assets/stylesheets/helpers/_linear-positions-parser.scss
158
+ - app/assets/stylesheets/helpers/_linear-side-corner-parser.scss
159
159
  - app/assets/stylesheets/helpers/_radial-arg-parser.scss
160
+ - app/assets/stylesheets/helpers/_radial-gradient-parser.scss
160
161
  - app/assets/stylesheets/helpers/_radial-positions-parser.scss
161
162
  - app/assets/stylesheets/helpers/_render-gradients.scss
162
163
  - app/assets/stylesheets/helpers/_shape-size-stripper.scss
163
- - app/assets/stylesheets/settings/_asset-pipeline.scss
164
+ - app/assets/stylesheets/helpers/_str-to-num.scss
164
165
  - app/assets/stylesheets/settings/_prefixer.scss
165
166
  - app/assets/stylesheets/settings/_px-to-em.scss
166
167
  - bin/bourbon
@@ -177,11 +178,11 @@ files:
177
178
  - dist/addons/_html5-input-types.scss
178
179
  - dist/addons/_position.scss
179
180
  - dist/addons/_prefixer.scss
181
+ - dist/addons/_rem.scss
180
182
  - dist/addons/_retina-image.scss
181
183
  - dist/addons/_size.scss
182
184
  - dist/addons/_timing-functions.scss
183
185
  - dist/addons/_triangle.scss
184
- - dist/addons/_word-wrap.scss
185
186
  - dist/css3/_animation.scss
186
187
  - dist/css3/_appearance.scss
187
188
  - dist/css3/_backface-visibility.scss
@@ -199,7 +200,6 @@ files:
199
200
  - dist/css3/_hidpi-media-query.scss
200
201
  - dist/css3/_hyphens.scss
201
202
  - dist/css3/_image-rendering.scss
202
- - dist/css3/_inline-block.scss
203
203
  - dist/css3/_keyframes.scss
204
204
  - dist/css3/_linear-gradient.scss
205
205
  - dist/css3/_perspective.scss
@@ -208,26 +208,30 @@ files:
208
208
  - dist/css3/_transform.scss
209
209
  - dist/css3/_transition.scss
210
210
  - dist/css3/_user-select.scss
211
+ - dist/functions/_assign.scss
211
212
  - dist/functions/_color-lightness.scss
212
213
  - dist/functions/_flex-grid.scss
213
214
  - dist/functions/_golden-ratio.scss
214
215
  - dist/functions/_grid-width.scss
215
- - dist/functions/_linear-gradient.scss
216
216
  - dist/functions/_modular-scale.scss
217
217
  - dist/functions/_px-to-em.scss
218
- - dist/functions/_px-to-rem.scss
219
- - dist/functions/_radial-gradient.scss
220
218
  - dist/functions/_strip-units.scss
221
219
  - dist/functions/_tint-shade.scss
222
220
  - dist/functions/_transition-property-name.scss
223
221
  - dist/functions/_unpack.scss
222
+ - dist/helpers/_convert-units.scss
224
223
  - dist/helpers/_gradient-positions-parser.scss
224
+ - dist/helpers/_is-num.scss
225
+ - dist/helpers/_linear-angle-parser.scss
226
+ - dist/helpers/_linear-gradient-parser.scss
225
227
  - dist/helpers/_linear-positions-parser.scss
228
+ - dist/helpers/_linear-side-corner-parser.scss
226
229
  - dist/helpers/_radial-arg-parser.scss
230
+ - dist/helpers/_radial-gradient-parser.scss
227
231
  - dist/helpers/_radial-positions-parser.scss
228
232
  - dist/helpers/_render-gradients.scss
229
233
  - dist/helpers/_shape-size-stripper.scss
230
- - dist/settings/_asset-pipeline.scss
234
+ - dist/helpers/_str-to-num.scss
231
235
  - dist/settings/_prefixer.scss
232
236
  - dist/settings/_px-to-em.scss
233
237
  - features/install.feature
@@ -242,6 +246,7 @@ files:
242
246
  - lib/bourbon/version.rb
243
247
  - lib/tasks/install.rake
244
248
  - package.json
249
+ - readme.md
245
250
  homepage: https://github.com/thoughtbot/bourbon
246
251
  licenses:
247
252
  - MIT
@@ -252,17 +257,17 @@ require_paths:
252
257
  - lib
253
258
  required_ruby_version: !ruby/object:Gem::Requirement
254
259
  requirements:
255
- - - ">="
260
+ - - '>='
256
261
  - !ruby/object:Gem::Version
257
262
  version: '0'
258
263
  required_rubygems_version: !ruby/object:Gem::Requirement
259
264
  requirements:
260
- - - ">="
265
+ - - '>'
261
266
  - !ruby/object:Gem::Version
262
- version: '0'
267
+ version: 1.3.1
263
268
  requirements: []
264
269
  rubyforge_project: bourbon
265
- rubygems_version: 2.2.2
270
+ rubygems_version: 2.2.1
266
271
  signing_key:
267
272
  specification_version: 4
268
273
  summary: Bourbon Sass Mixins using SCSS syntax.
data/README.md DELETED
@@ -1,126 +0,0 @@
1
- [![Bourbon](http://images.thoughtbot.com/bourbon/bourbon-logo.svg)](http://bourbon.io)
2
-
3
- ## A simple and lightweight mixin library for Sass.
4
-
5
- ### _This is the v3.2.4 branch_
6
-
7
- Bourbon is a library of pure Sass mixins that are designed to be simple and easy to use. No configuration required. The mixins aim to be as vanilla as possible, meaning they should be as close to the original CSS syntax as possible.
8
-
9
- The mixins contain vendor specific prefixes for all CSS3 properties for support amongst modern browsers. The prefixes also ensure graceful degradation for older browsers that support only CSS3 prefixed properties. Bourbon uses SCSS syntax.
10
-
11
- - **[Documentation](http://bourbon.io/docs)**
12
- - **[Changelog](https://github.com/thoughtbot/bourbon/releases)**
13
- - **[Issues & Bugs](https://github.com/thoughtbot/bourbon/issues)**
14
-
15
- ## Requirements
16
-
17
- - [Sass](https://github.com/sass/sass) 3.2+
18
-
19
- ## Installation
20
-
21
- For command line help, visit our wiki page on Bourbon’s [command line interface](https://github.com/thoughtbot/bourbon/wiki/Command-Line-Interface).
22
-
23
- 1. Install the Bourbon gem using the [RubyGems](https://rubygems.org) package manager:
24
-
25
- ```bash
26
- gem install bourbon
27
- ```
28
-
29
- Alternatively, you can install Bourbon with [Bower](http://bower.io).
30
-
31
- 2. Install the Bourbon library into the current directory:
32
-
33
- ```bash
34
- bourbon install
35
- ```
36
-
37
- **Pro Tip:** You can target installation into a specific directory using the `path` flag:
38
-
39
- ```bash
40
- bourbon install --path my/custom/path/
41
- ```
42
-
43
- 3. Import Bourbon at the beginning of your stylesheet:
44
-
45
- ```scss
46
- @import "bourbon/bourbon";
47
- ```
48
-
49
- It’s not recommended to add or modify the Bourbon files so that you can update them easily.
50
-
51
- ## Installation for Ruby on Rails 3.1+
52
-
53
- 1. Add Bourbon to your Gemfile:
54
-
55
- ```ruby
56
- gem 'bourbon'
57
- ```
58
-
59
- 2. Then run:
60
-
61
- ```bash
62
- bundle install
63
- ```
64
-
65
- 3. Restart your server and rename `application.css` to `application.css.scss`:
66
-
67
- ```bash
68
- mv app/assets/stylesheets/application.css app/assets/stylesheets/application.css.scss
69
- ```
70
-
71
- 4. Delete the sprocket directive in `application.css.scss` ([why?](https://github.com/thoughtbot/bourbon/wiki/Rails-Sprockets)):
72
-
73
- ```scss
74
- *= require_tree .
75
- ```
76
-
77
- 5. Import Bourbon at the beginning of `application.css.scss`. All additional stylesheets should be imported below Bourbon:
78
-
79
- ```scss
80
- @import "bourbon";
81
- @import "home";
82
- @import "users";
83
- ```
84
-
85
- [Help! I’m getting an undefined mixin error.](https://github.com/thoughtbot/bourbon/wiki/Rails-Help-%5C-Undefined-mixin)
86
-
87
- ## Installing older versions of Bourbon
88
-
89
- 1. Uninstall any Bourbon gem versions you already have:
90
-
91
- ```bash
92
- gem uninstall bourbon
93
- ```
94
-
95
- 2. Reinstall the Bourbon gem, using the `-v` flag to specify the version you need:
96
-
97
- ```bash
98
- gem install bourbon -v 3.2.4
99
- ```
100
-
101
- 3. Follow the [instructions above](#installation) to install Bourbon into your project.
102
-
103
- ## Browser support
104
-
105
- - Chrome 10.0+
106
- - Firefox 3.6+
107
- - Internet Explorer 9+
108
- - Opera 12+
109
- - Safari 5.1+
110
-
111
- ## The Bourbon family
112
-
113
- - [Bourbon](https://github.com/thoughtbot/bourbon): A simple and lightweight mixin library for Sass
114
- - [Neat](https://github.com/thoughtbot/neat): A lightweight semantic grid framework for Sass and Bourbon
115
- - [Bitters](https://github.com/thoughtbot/bitters): Scaffold styles, variables and structure for Bourbon projects
116
- - [Refills](https://github.com/thoughtbot/refills): Prepackaged patterns and components built with Bourbon, Neat and Bitters
117
-
118
- ## Credits
119
-
120
- [![thoughtbot](http://images.thoughtbot.com/bourbon/thoughtbot-logo.svg)](http://thoughtbot.com)
121
-
122
- Bourbon is maintained and funded by [thoughtbot, inc](http://thoughtbot.com). Tweet your questions or suggestions to [@bourbonsass](https://twitter.com/bourbonsass) and while you’re at it follow us too.
123
-
124
- ## License
125
-
126
- Copyright © 2011–2015 [thoughtbot, inc](http://thoughtbot.com). Bourbon is free software, and may be redistributed under the terms specified in the [license](LICENSE.md).