scc-less-rails-bootstrap 3.3.5.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (122) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +11 -0
  3. data/.travis.yml +41 -0
  4. data/Appraisals +19 -0
  5. data/CHANGELOG.md +186 -0
  6. data/CONTRIBUTING.md +18 -0
  7. data/Gemfile +6 -0
  8. data/Guardfile +5 -0
  9. data/ISSUES.md +35 -0
  10. data/README.md +130 -0
  11. data/Rakefile +20 -0
  12. data/app/assets/fonts/twitter/bootstrap/glyphicons-halflings-regular.eot +0 -0
  13. data/app/assets/fonts/twitter/bootstrap/glyphicons-halflings-regular.svg +288 -0
  14. data/app/assets/fonts/twitter/bootstrap/glyphicons-halflings-regular.ttf +0 -0
  15. data/app/assets/fonts/twitter/bootstrap/glyphicons-halflings-regular.woff +0 -0
  16. data/app/assets/fonts/twitter/bootstrap/glyphicons-halflings-regular.woff2 +0 -0
  17. data/app/assets/javascripts/twitter/bootstrap.js +12 -0
  18. data/app/assets/javascripts/twitter/bootstrap/affix.js +162 -0
  19. data/app/assets/javascripts/twitter/bootstrap/alert.js +94 -0
  20. data/app/assets/javascripts/twitter/bootstrap/button.js +120 -0
  21. data/app/assets/javascripts/twitter/bootstrap/carousel.js +237 -0
  22. data/app/assets/javascripts/twitter/bootstrap/collapse.js +211 -0
  23. data/app/assets/javascripts/twitter/bootstrap/dropdown.js +165 -0
  24. data/app/assets/javascripts/twitter/bootstrap/modal.js +337 -0
  25. data/app/assets/javascripts/twitter/bootstrap/popover.js +108 -0
  26. data/app/assets/javascripts/twitter/bootstrap/scrollspy.js +172 -0
  27. data/app/assets/javascripts/twitter/bootstrap/tab.js +155 -0
  28. data/app/assets/javascripts/twitter/bootstrap/tooltip.js +514 -0
  29. data/app/assets/javascripts/twitter/bootstrap/transition.js +59 -0
  30. data/app/assets/stylesheets/twitter/bootstrap.less +1 -0
  31. data/app/frameworks/twitter/bootstrap/alerts.less +73 -0
  32. data/app/frameworks/twitter/bootstrap/badges.less +66 -0
  33. data/app/frameworks/twitter/bootstrap/bootstrap.less +56 -0
  34. data/app/frameworks/twitter/bootstrap/breadcrumbs.less +26 -0
  35. data/app/frameworks/twitter/bootstrap/button-groups.less +244 -0
  36. data/app/frameworks/twitter/bootstrap/buttons.less +166 -0
  37. data/app/frameworks/twitter/bootstrap/carousel.less +269 -0
  38. data/app/frameworks/twitter/bootstrap/close.less +34 -0
  39. data/app/frameworks/twitter/bootstrap/code.less +69 -0
  40. data/app/frameworks/twitter/bootstrap/component-animations.less +33 -0
  41. data/app/frameworks/twitter/bootstrap/dropdowns.less +216 -0
  42. data/app/frameworks/twitter/bootstrap/forms.less +607 -0
  43. data/app/frameworks/twitter/bootstrap/glyphicons.less +305 -0
  44. data/app/frameworks/twitter/bootstrap/grid.less +84 -0
  45. data/app/frameworks/twitter/bootstrap/input-groups.less +167 -0
  46. data/app/frameworks/twitter/bootstrap/jumbotron.less +52 -0
  47. data/app/frameworks/twitter/bootstrap/labels.less +64 -0
  48. data/app/frameworks/twitter/bootstrap/list-group.less +130 -0
  49. data/app/frameworks/twitter/bootstrap/media.less +66 -0
  50. data/app/frameworks/twitter/bootstrap/mixins.less +40 -0
  51. data/app/frameworks/twitter/bootstrap/mixins/alerts.less +14 -0
  52. data/app/frameworks/twitter/bootstrap/mixins/background-variant.less +9 -0
  53. data/app/frameworks/twitter/bootstrap/mixins/border-radius.less +18 -0
  54. data/app/frameworks/twitter/bootstrap/mixins/buttons.less +68 -0
  55. data/app/frameworks/twitter/bootstrap/mixins/center-block.less +7 -0
  56. data/app/frameworks/twitter/bootstrap/mixins/clearfix.less +22 -0
  57. data/app/frameworks/twitter/bootstrap/mixins/forms.less +85 -0
  58. data/app/frameworks/twitter/bootstrap/mixins/gradients.less +59 -0
  59. data/app/frameworks/twitter/bootstrap/mixins/grid-framework.less +91 -0
  60. data/app/frameworks/twitter/bootstrap/mixins/grid.less +122 -0
  61. data/app/frameworks/twitter/bootstrap/mixins/hide-text.less +21 -0
  62. data/app/frameworks/twitter/bootstrap/mixins/image.less +33 -0
  63. data/app/frameworks/twitter/bootstrap/mixins/labels.less +12 -0
  64. data/app/frameworks/twitter/bootstrap/mixins/list-group.less +30 -0
  65. data/app/frameworks/twitter/bootstrap/mixins/nav-divider.less +10 -0
  66. data/app/frameworks/twitter/bootstrap/mixins/nav-vertical-align.less +9 -0
  67. data/app/frameworks/twitter/bootstrap/mixins/opacity.less +8 -0
  68. data/app/frameworks/twitter/bootstrap/mixins/pagination.less +24 -0
  69. data/app/frameworks/twitter/bootstrap/mixins/panels.less +24 -0
  70. data/app/frameworks/twitter/bootstrap/mixins/progress-bar.less +10 -0
  71. data/app/frameworks/twitter/bootstrap/mixins/reset-filter.less +8 -0
  72. data/app/frameworks/twitter/bootstrap/mixins/reset-text.less +18 -0
  73. data/app/frameworks/twitter/bootstrap/mixins/resize.less +6 -0
  74. data/app/frameworks/twitter/bootstrap/mixins/responsive-visibility.less +15 -0
  75. data/app/frameworks/twitter/bootstrap/mixins/size.less +10 -0
  76. data/app/frameworks/twitter/bootstrap/mixins/tab-focus.less +9 -0
  77. data/app/frameworks/twitter/bootstrap/mixins/table-row.less +28 -0
  78. data/app/frameworks/twitter/bootstrap/mixins/text-emphasis.less +9 -0
  79. data/app/frameworks/twitter/bootstrap/mixins/text-overflow.less +8 -0
  80. data/app/frameworks/twitter/bootstrap/mixins/vendor-prefixes.less +227 -0
  81. data/app/frameworks/twitter/bootstrap/modals.less +150 -0
  82. data/app/frameworks/twitter/bootstrap/navbar.less +660 -0
  83. data/app/frameworks/twitter/bootstrap/navs.less +242 -0
  84. data/app/frameworks/twitter/bootstrap/normalize.less +424 -0
  85. data/app/frameworks/twitter/bootstrap/pager.less +54 -0
  86. data/app/frameworks/twitter/bootstrap/pagination.less +89 -0
  87. data/app/frameworks/twitter/bootstrap/panels.less +271 -0
  88. data/app/frameworks/twitter/bootstrap/popovers.less +131 -0
  89. data/app/frameworks/twitter/bootstrap/print.less +101 -0
  90. data/app/frameworks/twitter/bootstrap/progress-bars.less +87 -0
  91. data/app/frameworks/twitter/bootstrap/responsive-embed.less +35 -0
  92. data/app/frameworks/twitter/bootstrap/responsive-utilities.less +194 -0
  93. data/app/frameworks/twitter/bootstrap/scaffolding.less +161 -0
  94. data/app/frameworks/twitter/bootstrap/tables.less +234 -0
  95. data/app/frameworks/twitter/bootstrap/theme.less +291 -0
  96. data/app/frameworks/twitter/bootstrap/thumbnails.less +36 -0
  97. data/app/frameworks/twitter/bootstrap/tooltip.less +101 -0
  98. data/app/frameworks/twitter/bootstrap/type.less +302 -0
  99. data/app/frameworks/twitter/bootstrap/utilities.less +55 -0
  100. data/app/frameworks/twitter/bootstrap/variables.less +867 -0
  101. data/app/frameworks/twitter/bootstrap/wells.less +29 -0
  102. data/less-rails-bootstrap.gemspec +25 -0
  103. data/lib/generators/less_rails_bootstrap/custom_bootstrap/custom_bootstrap_generator.rb +67 -0
  104. data/lib/scc-less-rails-bootstrap.rb +11 -0
  105. data/lib/scc/less/rails/bootstrap.rb +2 -0
  106. data/lib/scc/less/rails/bootstrap/engine.rb +17 -0
  107. data/lib/scc/less/rails/bootstrap/version.rb +9 -0
  108. data/scc-less-rails-bootstrap.gemspec +25 -0
  109. data/scripts/update_bootstrap.sh +97 -0
  110. data/test/cases/engine_spec.rb +15 -0
  111. data/test/cases/generators/custom_bootstrap_generator_test.rb +34 -0
  112. data/test/cases/usage_css_spec.rb +74 -0
  113. data/test/cases/usage_js_spec.rb +34 -0
  114. data/test/dummy_app/app/assets/javascripts/application.js +3 -0
  115. data/test/dummy_app/app/assets/javascripts/individual.js +2 -0
  116. data/test/dummy_app/app/assets/stylesheets/application.css +6 -0
  117. data/test/dummy_app/app/assets/stylesheets/fonts.css.less +2 -0
  118. data/test/dummy_app/app/assets/stylesheets/framework.css.less +8 -0
  119. data/test/dummy_app/app/assets/stylesheets/individual.css.less +10 -0
  120. data/test/dummy_app/init.rb +22 -0
  121. data/test/spec_helper.rb +76 -0
  122. metadata +260 -0
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 3b8f0a270661804e203cb0327adb91812db3d5ea
4
+ data.tar.gz: 8142f56f3d5f5d3a2688eea1930fed67f52db817
5
+ SHA512:
6
+ metadata.gz: d36f55c6c89bbeb8aef6a1ee340819966e99a05154d4cc3e63b5ef463189513723cbfbe6788c86069ee2e24ca0eb9a5d27861b48c99a2edd664993cc83b445bb
7
+ data.tar.gz: 38b92ae54475b3e090850c1af726e311287898600490a6a2a2ca39afa4cdce764373698ed9dee40f36beb0006611c1791e3576e27239648af05ca3932b2a25d9
@@ -0,0 +1,11 @@
1
+ *.gem
2
+ .bundle
3
+ *.lock
4
+ pkg/*
5
+ *.log
6
+ test/dummy_app/log/*
7
+ test/dummy_app/tmp/*
8
+ tmp/*
9
+ /twitter/
10
+ gemfiles/*.gemfile
11
+ test/dummy_app/tmp/
@@ -0,0 +1,41 @@
1
+ language: ruby
2
+ cache: bundler
3
+ sudo: false
4
+ rvm:
5
+ - 1.9.3-p551
6
+ - 2.0.0-p648
7
+ - 2.1.10
8
+ - 2.2.7
9
+ - 2.3.4
10
+ - 2.4.1
11
+ - jruby-9.1.9.0
12
+ before_install:
13
+ - gem install bundler
14
+ install:
15
+ - bundle install --jobs=3 --retry=3
16
+ script:
17
+ - bundle exec rake
18
+ gemfile:
19
+ - gemfiles/rails40.gemfile
20
+ - gemfiles/rails41.gemfile
21
+ - gemfiles/rails42.gemfile
22
+ - gemfiles/rails50.gemfile
23
+ - gemfiles/rails51.gemfile
24
+ matrix:
25
+ exclude:
26
+ - rvm: 1.9.3-p551
27
+ gemfile: gemfiles/rails50.gemfile
28
+ - rvm: 1.9.3-p551
29
+ gemfile: gemfiles/rails51.gemfile
30
+ - rvm: 2.0.0-p648
31
+ gemfile: gemfiles/rails50.gemfile
32
+ - rvm: 2.0.0-p648
33
+ gemfile: gemfiles/rails51.gemfile
34
+ - rvm: 2.1.10
35
+ gemfile: gemfiles/rails50.gemfile
36
+ - rvm: 2.1.10
37
+ gemfile: gemfiles/rails51.gemfile
38
+ - rvm: 2.4.1
39
+ gemfile: gemfiles/rails40.gemfile
40
+ - rvm: 2.4.1
41
+ gemfile: gemfiles/rails41.gemfile
@@ -0,0 +1,19 @@
1
+ appraise 'rails40' do
2
+ gem 'rails', '~> 4.0.13'
3
+ end
4
+
5
+ appraise 'rails41' do
6
+ gem 'rails', '~> 4.1.16'
7
+ end
8
+
9
+ appraise 'rails42' do
10
+ gem 'rails', '~> 4.2.8'
11
+ end
12
+
13
+ appraise 'rails50' do
14
+ gem 'rails', '~> 5.0.3'
15
+ end
16
+
17
+ appraise 'rails51' do
18
+ gem 'rails', '~> 5.1.1'
19
+ end
@@ -0,0 +1,186 @@
1
+ # 3.3.4.0 - 2015-04-26
2
+
3
+ * Bump less-rails dependency to allow Sprockets 3
4
+ * Update to Twitter Bootstrap 3.3.4
5
+
6
+ # 3.3.2.0 - 2015-01-20
7
+
8
+ * Update to Twitter Bootstrap 3.3.2
9
+
10
+ # 3.3.1.0 - 2014-11-13
11
+
12
+ * Update to Twitter Bootstrap 3.3.1
13
+
14
+ # 3.3.0.1 - 2014-11-07
15
+
16
+ * Update to less-rails 2.6.0.
17
+
18
+ # 3.3.0.0 - 2014-11-02
19
+
20
+ * Update to Twitter Bootstrap 3.3.0
21
+
22
+ # 3.2.0 - 2014-06-26
23
+
24
+ * Update to Twitter Bootstrap 3.2.0
25
+
26
+ # 3.1.1.1 - 2014-03-19
27
+
28
+ * Update to less-rails ~> 2.5.0
29
+
30
+ # 3.1.1.0 - 2014-02-15
31
+
32
+ * Update to Twitter Bootstrap 3.1.1
33
+
34
+
35
+ # 3.1.0.0 - 2014-01-30
36
+
37
+ * Update to Twitter Bootstrap 3.1.0
38
+
39
+
40
+ # 3.0.6 - 2013-12-06
41
+
42
+ * Update to Twitter Bootstrap 3.0.3
43
+
44
+
45
+ # 3.0.5 - 2013-11-07
46
+
47
+ * Update to Twitter Bootstrap 3.0.2
48
+
49
+
50
+ # 3.0.4 - 2013-10-31
51
+
52
+ * Update to Twitter Bootstrap 3.0.1
53
+
54
+ # 3.0.3 - 2013-09-01
55
+
56
+ * Update to less-rails 2.4.2 or higher. Fix initializers for 2.4.2 too.
57
+ * Remove Rails 3.1 with Ruby 2.0 build support. Sprockets will not work!
58
+
59
+ # 3.0.2 - 2013-09-01
60
+
61
+ * Cross platform update script.
62
+ * Implement Rails generator to simplify customization of Bootstrap.
63
+ * Generate bootstrap.js from twitter/bootstrap/Gruntfile.js
64
+
65
+ # 3.0.1 - 2013-08-29
66
+
67
+ * Another proper 3.0.0 bootstrap release.
68
+
69
+ # 3.0.0.1 - 2013-08-20
70
+
71
+ * proper 3.0.0 release
72
+
73
+ # 3.0.0 (yanked) - 2013-08-20
74
+
75
+ * Update boostrap to 3.0.0
76
+
77
+ # 2.3.3 - 2013-03-07
78
+
79
+ * Update boostrap to 2.3.2.
80
+
81
+ # 2.3.2 - 2013-03-07
82
+
83
+ * Update to less-rails 2.3.1. Really uses less v1.3.3
84
+ * Update boostrap to 2.3.1.
85
+
86
+ # 2.3.1 - 2013-03-06
87
+
88
+ * Update to less-rails 2.3.0.
89
+
90
+ # 2.3.0 - 2013-01-24
91
+
92
+ * Update boostrap to 2.3.0. Thanks to all that helped!
93
+
94
+ # 2.2.1 - 2013-01-14
95
+
96
+ * Update bootstrap to 2.2.2. Thanks to @trentclowater
97
+
98
+ # 2.2.0 - 2012-10-31
99
+
100
+ * Update bootstrap to 2.2.1. Thanks to @spider-network
101
+
102
+ # 2.1.1 - 2012-09-05
103
+
104
+ * Use bootstrap 2.1.1. Thanks @erdah.
105
+
106
+ # 2.1.0 - 2012-08-20
107
+
108
+ * Use bootstrap 2.1.0. Thanks @vickash.
109
+
110
+ # 2.0.13 - 2012-06-07
111
+
112
+ * Update to bootstrap 2.0.4.
113
+
114
+ # 2.0.12 - 2012-04-25
115
+
116
+ * Work with latest less.rb v2.2.1.
117
+
118
+ # 2.0.11 - 2012-04-25
119
+
120
+ * Update to bootstrap 2.0.3.
121
+
122
+ # 2.0.10 - 2012-04-04
123
+
124
+ * Include a way to require the responsive responsive file.
125
+
126
+ # 2.0.9 - 2012-04-04
127
+
128
+ * Bumping the less-rails depedency so everyone can use therubyracer 0.10.0.
129
+
130
+ # 2.0.8 - 2012-03-13
131
+
132
+ * Fix icon sprite paths. Seems they are real paths now.
133
+
134
+ # 2.0.7 - 2012-03-13
135
+
136
+ * Update to official bootstrap 2.0.2
137
+
138
+ # 2.0.6 - 2012-02-15
139
+
140
+ * Update to official bootstrap 2.0.1
141
+
142
+ # 2.0.5 - 2012-02-15
143
+
144
+ * Fix .nav-list .active > a:hover Fixes #30
145
+
146
+ # 2.0.3, 2.0.4 - 02-03/2012
147
+
148
+ * Fix IE9 background hack from bootstrap upstream.
149
+ * Misc border-radius 0px fixes.
150
+
151
+ # 2.0.2 - 2012-02-01
152
+
153
+ * Change require order for tooltip.js [Rufus Post]
154
+
155
+ # 2.0.1 - 2012-01-31
156
+
157
+ * Package up Glyphicons and use less-rails' asset-url() helper.
158
+
159
+ # 2.0.0 - 2012-01-31
160
+
161
+ * Update to Twitter Bootstrap 2.0.0
162
+
163
+ # 1.4.1 - 2011-11-18
164
+
165
+ * Update to use less-rails ~> 2.1.0
166
+
167
+ # 1.4.0 - 2011-11-05
168
+
169
+ * Bootstrap update (f92759b36db43e782e4235f1f214ac5851383f9b)
170
+
171
+ # 1.3.3 - 2011-10-09
172
+
173
+ * Move bootstrap LESS files to vendor/frameworks. Should fix assets:precompile bugs.
174
+ * New test setup and hopefully a more sane engine initializer.
175
+
176
+ # 1.3.2 - 2011-09-28
177
+
178
+ * Require less-rails properly. Thanks Benoit Bénézech (bbenezech).
179
+
180
+ # 1.3.1 - 2011-09-26
181
+
182
+ * Require twipsy before popover [stratequip]
183
+
184
+ # 1.3.0 - 2011-09-25
185
+
186
+ * Initial 1.3.0 release (68605bdd51760a929cc661607f06f479c53b0bee)
@@ -0,0 +1,18 @@
1
+ # Creating Issues
2
+
3
+ If you are having a problem, please see our [ISSUES](https://github.com/metaskills/less-rails-bootstrap/blob/master/ISSUES.md) page for troubleshooting steps and a guide for submitting a ticket that will help us solve the problem you are having as quickly as possible.
4
+
5
+ ## Contributing
6
+
7
+ Here are the steps to update the version of twitter bootstrap used.
8
+
9
+ * Clone this repository.
10
+ * Run the `./scripts/update_bootstrap.sh` script with bootstrap repo version tag argument. For example `./scripts/update_bootstrap.sh v3.0.0`.
11
+ * Make your changes
12
+ * Run the tests by doing:
13
+
14
+ ```
15
+ $ bundle
16
+ $ bundle exec appraisal install
17
+ $ bundle exec appraisal rake
18
+ ```
data/Gemfile ADDED
@@ -0,0 +1,6 @@
1
+ source 'https://rubygems.org'
2
+
3
+ gemspec
4
+
5
+ gem "therubyracer", "~> 0.12.0", :require => nil, :platforms => :ruby
6
+ gem "therubyrhino", "~> 2.0.2", :require => nil, :platforms => :jruby
@@ -0,0 +1,5 @@
1
+ guard 'minitest' do
2
+ watch(%r|^lib/less/rails/bootstrap/(.*)\.rb|) { |m| "test/cases/#{m[1]}_spec.rb" }
3
+ watch(%r|^test/spec_helper\.rb|) { "test/cases" }
4
+ watch(%r|^test/cases/(.*)_spec\.rb|)
5
+ end
@@ -0,0 +1,35 @@
1
+ # less-rails-bootstrap Issues
2
+
3
+ ## Troubleshooting
4
+
5
+ Please try to update to latest version with `bundle update less-rails-bootstrap` before creating an issue.
6
+
7
+ Do not forget to lock major version in `Gemfile`.
8
+
9
+ **For Twitter Bootstrap 2.3 use:**
10
+
11
+ ```ruby
12
+ gem 'less-rails-bootstrap', '~> 2.3.3'
13
+ ```
14
+
15
+ **For Twitter Bootstrap 3 use:**
16
+
17
+ ```ruby
18
+ gem 'less-rails-bootstrap', '~> 3.0.0'
19
+ ```
20
+
21
+ If you are looking for older versions of Twitter Bootstrap or you're facing the wrong path to Twitter Bootstrap resources problem, then try the following steps:
22
+
23
+ * reset Asset Pipeline cache with `rake tmp:clear`
24
+ * check settings related to caching inside 'environments/*.rb' files
25
+ * remove `assets` directory from `public` directory if it exists in your development environment
26
+
27
+ ## Reporting problems
28
+
29
+ Please include:
30
+
31
+ - Your rails version (you can find in `Gemfile.lock`)
32
+ - Your less-rails-bootstrap version (you can find in `Gemfile.lock`)
33
+ - What version of Ruby you are using (run `ruby -v`)
34
+
35
+ Thanks for reporting an issue and helping make less-rails-bootstrap better!
@@ -0,0 +1,130 @@
1
+ # Less Rails Bootstrap [![Build Status](https://travis-ci.org/metaskills/less-rails-bootstrap.png?branch=master)](https://travis-ci.org/metaskills/less-rails-bootstrap)
2
+
3
+ Bootstrap is Twitter's toolkit for kickstarting your site or app's CSS. It includes base styles for typography, forms, buttons, tables, grid layout, navigation, alerts, and more. To get started -- check out the [Bootstrap docs](http://getbootstrap.com/).
4
+
5
+ The less-rails-bootstrap project hooks into [less-rails](http://github.com/metaskills/less-rails) and [less.rb](http://github.com/cowboyd/less.rb), making Bootstrap's source LESS files, compiled CSS, and JavaScript files available in the Rails 4.x and 5.x asset pipeline.
6
+
7
+ The benefits:
8
+
9
+ * Assets are namespaced in twitter/bootstrap to avoid asset conflicts.
10
+ * Top level requires to get all stylesheets or javascripts.
11
+ * Ability to import or require individually namespaced stylesheets or javascripts.
12
+
13
+
14
+ ## Installation
15
+
16
+ LESS requires a JavaScript runtime to work. Which one you use depends on your Ruby implementation. Two are shown for Ruby (MRI) and JRuby. Add only the relevant one to your Gemfile. If you want to use Bootstrap's JavaScript plugins, also add the `jquery-rails` gem. Finally, add `less-rails-bootstrap` and run `bundle install`.
17
+
18
+ ```ruby
19
+ # Gemfile
20
+
21
+ gem 'therubyracer' # If using Ruby
22
+ gem 'therubyrhino' # If using JRuby
23
+ gem 'jquery-rails' # If using Bootstrap's JS plugins.
24
+ gem 'less-rails-bootstrap'
25
+ ```
26
+
27
+ ## Basic CSS Use
28
+
29
+ ### Simple way
30
+
31
+ Get the full Bootstrap stylesheet with a single line in your `application.css`.
32
+
33
+ ```
34
+ /*
35
+ *= require twitter/bootstrap
36
+ */
37
+ ```
38
+
39
+ ### Advanced way
40
+
41
+ In case when you just want to modify several LESS variables (i.e. change text color, etc.) and don't want to thinking about [Full Control & Customization](https://github.com/metaskills/less-rails-bootstrap-test#full-control--customization) you can run Rails generator:
42
+
43
+ ```
44
+ rails generate less_rails_bootstrap:custom_bootstrap
45
+ ```
46
+
47
+ It generates three files:
48
+
49
+ * `app/assets/stylesheets/custom_bootstrap/custom_bootstrap.less` - auto-generated file base on bootstrap.less file from original Twitter Bootstrap. Don't modify it!
50
+ * `app/assets/stylesheets/custom_bootstrap/variables.less` - in this file you can override Twitter Bootstrap variables or define own
51
+ * `app/assets/stylesheets/custom_bootstrap/mixins.less` - in this file you can override Twitter Bootstrap mixins or define own
52
+
53
+ Then just add single line to `application.css`.
54
+
55
+ ```
56
+ /*
57
+ *= require custom_bootstrap/custom_bootstrap
58
+ */
59
+ ```
60
+
61
+ > Please see the [less-rails-bootstrap-test](http://github.com/metaskills/less-rails-bootstrap-test) repo for examples that customize the CSS output by using LESS. The "CSS Tests Suites" section of the README and code is what you want to focus on. Also, check out the [LESS syntax](http://lesscss.org/).
62
+
63
+ ## Basic JavaScript Use
64
+
65
+ In `application.js`, require jQuery first. Now you can add all the Bootstrap plugins with a single line.
66
+
67
+ ````
68
+ //= require jquery
69
+ //= require jquery_ujs
70
+ //= require twitter/bootstrap
71
+ ````
72
+
73
+ Or include plugins individually.
74
+
75
+ ````
76
+ //= require jquery
77
+ //= require jquery_ujs
78
+ //= require twitter/bootstrap/modal
79
+ //= require twitter/bootstrap/alert
80
+ ````
81
+
82
+
83
+ ## Versioning
84
+
85
+ This gem will directly track the semantic versioning of the Twitter Bootstrap project. Our major and minor versions will always match to theirs, though we may have tiny patch level releases specific to this gem.
86
+
87
+
88
+ ## Contributing
89
+
90
+ This gem is fully tested from Rails 4.0 to 5.2. We run our tests on [Travis CI](http://travis-ci.org/metaskills/less-rails-boostrap) in both Ruby 1.9, 2.0 and jRuby 9000. If you detect a problem, open up a github issue or fork the repo and help out. After you fork or clone the repository, the following commands will get you up and running on the test suite.
91
+
92
+ ```shell
93
+ $ bundle
94
+ $ bundle exec appraisal install
95
+ $ bundle exec appraisal test
96
+ ```
97
+
98
+ We use the [appraisal](https://github.com/thoughtbot/appraisal) gem from Thoughtbot to help us generate the individual gemfiles for each Rails version and to run the tests locally against each generated Gemfile. The `appraisal test` command actually runs our test suite against all Rails versions in our `Appraisal` file. If you want to run the tests for a specific Rails version, use `rake -T` for a list. For example, the following command will run the tests for Rails 4.0 only.
99
+
100
+ ```shell
101
+ $ bundle exec appraisal rails40 rake test
102
+ ```
103
+
104
+ Our current build status is:
105
+ [![Build Status](https://secure.travis-ci.org/metaskills/minitest-spec-rails.png)](http://travis-ci.org/metaskills/less-rails-bootstrap) read more in our [CONTRIBUTING](https://github.com/metaskills/less-rails-bootstrap/blob/master/CONTRIBUTING.md) file.
106
+
107
+
108
+
109
+ ## License
110
+
111
+ Twitter Bootstrap Project: http://twitter.github.com/bootstrap
112
+
113
+ Copyright 2011 Twitter, Inc.
114
+
115
+ Licensed under the Apache License, Version 2.0 (the "License");
116
+ you may not use this file except in compliance with the License.
117
+ You may obtain a copy of the License at
118
+
119
+ http://www.apache.org/licenses/LICENSE-2.0
120
+
121
+ Unless required by applicable law or agreed to in writing, software
122
+ distributed under the License is distributed on an "AS IS" BASIS,
123
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
124
+ See the License for the specific language governing permissions and
125
+ limitations under the License.
126
+
127
+ Less::Rails is Copyright (c) 2011 Ken Collins, <ken@metaskills.net> and is distributed under the MIT license.
128
+
129
+
130
+