middleman-sprockets 4.0.0.rc.3 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 51021db335e75bc9e5a93a65b56db0fb1b89fc5e
-  data.tar.gz: 7200150e16a3888f9015c759fde9b14e5a65e6be
+  metadata.gz: 86865e460e1617af5a3f81e9cc930942be536fa3
+  data.tar.gz: 802e29f35cf071c20ae0b1f1b4a5c9f3757290f5
 SHA512:
-  metadata.gz: 7272ff377038976d9fe1d314c9b931c5dbefb7b46122a605012a4fc6e9301b4105d0ee6f9ff639f099fa17c400f6e27b422ece03308381ad3ae1ca3c54f67f67
-  data.tar.gz: 64cdd14315877463aad4eeb6b987ff1fd44d545a7e0ada7fefad291db366da1debc8036455fbda110014481fa705a4f8e637e8c52ed65e2d7a6e08175f6a443d
+  metadata.gz: 336453668799d7142aedd42254284f2669be18621fce2155a5305458d60157b3d371f0997670dbc63478d1c39f2b9339d0215e737c6d3f7722ccc697acb9eab1
+  data.tar.gz: dee36dffef49106f12396092625551fafa3894e5a345212b7c873b09d7c42d18372f6ec6fc46adf23b13684f3c9bb9885079c72845ca82eff50c699edbd64e84

data/README.md

@@ -27,6 +27,7 @@ activate :sprockets
 ### Usage
 
 - [Basic Usage](features/basic_usage.feature)
+- [With Rails Assets](docs/usage-with-rails-assets.md)
 - [With Asset Gems](features/asset_gems.feature)
 - [With Bower](features/bower.feature)
 - [Linked Assets](features/linked_assets.feature)

data/docs/usage-with-rails-assets.md

@@ -0,0 +1,80 @@
+## Usage with Rails Assets
+
+One of the simplest ways to use middleman-sprockets to manage frontend assets is via [Rails Assets](https://rails-assets.org). Rails Assets is a frictionless proxy between Bundler and Bower to manage Bower-based assets through your existing Gemfile, and then letting the asset pipeline handle the rest.
+
+Here's a quick guide to using Rails Assets with a new Middleman 4 site:
+
+1. Go to [rails-assets.org](https://rails-assets.org) and identify your dependency and version. Chances are it's already there; rails-assets then packages your dependency as a gem on demand for consumption by Bundler.
+
+2. In your Gemfile, add sprockets and a rails-assets block with the gemfiles chosen from step 1:
+
+  ```
+  # Gemfile
+  gem 'middleman-sprockets', '4.0.0.rc.3'
+
+  source 'https://rails-assets.org' do
+    gem 'rails-assets-bootstrap-autohidingnavbar', '1.0.0'
+    gem 'rails-assets-jquery', '2.1.1'
+    gem 'rails-assets-slick.js', '1.5.7'
+  end
+  ```
+
+3. In your config.rb, add the following block to enable the asset pipeline and add RailsAssets gems to your load path:
+
+  ```
+  # config.rb
+  # General configuration
+  activate :sprockets
+
+  if defined? RailsAssets
+    RailsAssets.load_paths.each do |path|
+      sprockets.append_path path
+    end
+  end
+  ```
+
+4. run `bundle install`
+
+5. Add the necessary import statements to your site.css.scss and all.js files. Note that rails-assets may suggest a sprockets `//= slick.js` import statement, but if the library is packaged with SASS, you likely want to use a SASS import `@import "slick.js";` instead.
+
+
+You may run into edge cases where the assets in the generated gem are not packaged in a traditional way, or if you only need a subset of the library's functionality. In those cases, a quick
+
+```
+cd `bundle show gemname`
+```
+
+and opening up the library in your text editor will show you the necessary path & file information. In the example above, since slick.js ends with .js, make sure you specify the javascript import as:
+
+```
+ //= require slick.js.js
+```
+
+Finally, note that you can still use traditional hand-packaged gems like bootstrap-sass and font-awesome-sass in your Gemfile as well. Here's a complete Gemfile for reference:
+
+```
+# If you do not have OpenSSL installed, change
+# the following line to use 'http://'
+source 'https://rubygems.org'
+
+# For faster file watcher updates on Windows:
+# gem 'wdm', '~> 0.1.0', platforms: [:mswin, :mingw]
+
+# Windows does not come with time zone data
+# gem 'tzinfo-data', platforms: [:mswin, :mingw, :jruby]
+
+# Middleman Gems
+gem 'middleman', '>= 4.0.0'
+gem 'middleman-livereload'
+gem 'middleman-compass', '>= 4.0.0'
+gem 'middleman-sprockets', '4.0.0.rc.3'
+
+gem 'bootstrap-sass'
+gem 'font-awesome-sass'
+
+source 'https://rails-assets.org' do
+  gem 'rails-assets-bootstrap-autohidingnavbar', '1.0.0'
+  gem 'rails-assets-jquery', '2.1.1'
+  gem 'rails-assets-slick.js', '1.5.7'
+end
+```

data/lib/middleman-sprockets/version.rb

@@ -1,5 +1,5 @@
 module Middleman
   module Sprockets
-    VERSION = '4.0.0.rc.3'.freeze
+    VERSION = '4.0.0'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: middleman-sprockets
 version: !ruby/object:Gem::Version
-  version: 4.0.0.rc.3
+  version: 4.0.0
 platform: ruby
 authors:
 - Thomas Reynolds
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-24 00:00:00.000000000 Z
+date: 2016-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: middleman-core
@@ -76,6 +76,7 @@ files:
 - README.md
 - Rakefile
 - docs/upgrade-3-to-4.md
+- docs/usage-with-rails-assets.md
 - features/asset_gems.feature
 - features/basic_usage.feature
 - features/bower.feature
@@ -167,9 +168,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.4.8