jekyll-assets 0.2.2 → 0.2.3

data/HISTORY.md

@@ -0,0 +1,38 @@
+### 0.2.3 (2013-01-07)
+
+* Add built-in bourbon support as: `require "jekyll-assets/bourbon"`.
+
+
+### 0.2.2 (2013-01-07)
+
+* Add built-in compass support as: `require "jekyll-assets/compass"`.
+
+
+### 0.2.1 (2012-12-31)
+
+* Expose `Jekyll::Site` instance into assets as `site`.
+* Improve assets comparison (when required with different logical names).
+
+
+### 0.2.0 (2012-12-28)
+
+* Remove logging.
+* Fix `asset_path` helper within assets.
+* Remove `bundles` configuration option.
+  All require assets are auto-bundled now.
+
+
+### 0.1.1 (2012-12-21)
+
+* Add `baseurl` configuration option.
+
+
+### 0.1.1 (2012-10-23)
+
+* Small bug fixes and improvements.
+* Add `{% asset <logical_path> %}` Liquid tag.
+
+
+### 0.1.0 (2012-10-22)
+
+* First public release.

data/README.md

@@ -17,6 +17,11 @@ Jekyll plugin, that adds Rails-alike assets pipeline, that means that:
   compiled to JavaScript functions.
 - Automaticaly adds MD5 fingerprint suffix for _cache busting_. That means
   that your `app.css` will become `app-908e25f4bf641868d8683022a5b62f54.css`.
+- [Compass][compass] and [Bourbon][bourbon] built-in support.
+  See "Custom Vendors" below.
+
+[compass]: http://compass-style.org/
+[bourbon]: http://bourbon.io/
 
 Jekyll-Assets uses fabulous [Sprockets][sprockets] under the hood, so you may
 refer to Rails guide about [Asset Pipeline][rails-guide] for detailed
@@ -185,6 +190,67 @@ That's all. Feel free to ask questions if any on [twitter][twitter],
 [e-mail]:   mailto://ixti@member.fsf.org
 
 
+## Custom Vendors
+
+Sometimes you would like to have some 3rd-party vendors. For this purposes,
+normally all you have to do is to override default assets sources in config:
+
+``` yaml
+assets:
+  sources:
+    - _assets/images
+    - _assets/javascripts
+    - _assets/stylesheets
+    - _vendors/bootstrap/stylesheets
+    - _vendors/bootstrap/javascripts
+```
+
+But sometimes this is not enough. For example, with compass. As jekyll-assets
+uses Sprockets internally, you can simply append "global" paths into it. Just
+add following line into your `_plugins/ext.rb` file:
+
+``` ruby
+require "sprockets"
+
+Sprockets.append_path "/my/vendor"
+```
+
+That's it, now jekyll-assets will try to look for assets inside `/my/vendor`
+path first.
+
+
+### Built-in Vendors Support
+
+For your comfort jekyll-assets has built-in support for some popular libraries.
+
+
+#### Compass Support
+
+Require `jekyll-assets/compass` to enable, e.g.:
+
+``` ruby
+require "jekyll-assets"
+require "jekyll-assets/compass"
+```
+
+Now you can add `@import "compass"` in your SASS assets to get Compass goodies.
+
+*Notice* that if you want to use other than default Compass plugins/frameworks,
+you must require them BEFORE `jekyll-assets/compass`.
+
+
+#### Bourbon Support
+
+Require `jekyll-assets/bourbon` to enable, e.g.:
+
+``` ruby
+require "jekyll-assets"
+require "jekyll-assets/bourbon"
+```
+
+Now you can add `@import "bourbon"` in your SASS assets to get Bourbon goodies.
+
+
 ## The Directive Processor
 
 *Note:* This section extracted from [Sprockets][sprockets] README.

data/jekyll-assets.gemspec

@@ -23,6 +23,7 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency "guard-rspec"
   gem.add_development_dependency "rb-inotify"
   gem.add_development_dependency "compass"
+  gem.add_development_dependency "bourbon"
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/lib/jekyll-assets/bourbon.rb

@@ -0,0 +1,5 @@
+require "sprockets"
+
+
+bourbon_root = Gem::Specification.find_by_name("bourbon").gem_dir
+Sprockets.append_path File.join(bourbon_root, "app", "assets", "stylesheets")

data/lib/jekyll/assets_plugin/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
   module AssetsPlugin
-    VERSION = "0.2.2"
+    VERSION = "0.2.3"
   end
 end

data/spec/fixtures/_assets/vendor/bourbon.css.sass

@@ -0,0 +1,4 @@
+@import "bourbon"
+
+.photo
+  @include box-shadow(0 0 5px 0px hsla(0, 0%, 0%, 0.65))

data/spec/fixtures/_assets/{photos.css.sass → vendor/compass.css.sass}

@@ -1,4 +1,4 @@
-@import "compass/css3/box-shadow"
+@import "compass"
 
 .photo
   @include single-box-shadow(#eee, 0px, 0px, 5px)

data/spec/lib/jekyll-assets/bourbon_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+require 'jekyll-assets/bourbon'
+
+
+module Jekyll::AssetsPlugin
+  describe 'Bourbon integration' do
+    it "should globally append bourbon paths into Sprockets environment" do
+      asset = @site.assets['vendor/bourbon.css'].to_s
+
+      asset.should =~ /-webkit-box-shadow/
+      asset.should =~ /box-shadow/
+    end
+  end
+end

data/spec/lib/jekyll-assets/compass_spec.rb

@@ -5,7 +5,11 @@ require 'jekyll-assets/compass'
 module Jekyll::AssetsPlugin
   describe 'Compass integration' do
     it "should globally append compass paths into Sprockets environment" do
-      puts @site.assets['photos.css'].to_s
+      asset = @site.assets['vendor/compass.css'].to_s
+
+      asset.should =~ /-webkit-box-shadow/
+      asset.should =~ /-moz-box-shadow/
+      asset.should =~ /box-shadow/
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-assets
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-06 00:00:00.000000000 Z
+date: 2013-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -123,6 +123,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: bourbon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ! "  Jekyll plugin, that allows you to write javascript/css assets in\n
   \ other languages such as CoffeeScript, Sass, Less and ERB, concatenate\n  them,
   respecting dependencies, minify and many more.\n"
@@ -137,11 +153,13 @@ files:
 - .travis.yml
 - Gemfile
 - Guardfile
+- HISTORY.md
 - LICENSE
 - README.md
 - Rakefile
 - jekyll-assets.gemspec
 - lib/jekyll-assets.rb
+- lib/jekyll-assets/bourbon.rb
 - lib/jekyll-assets/compass.rb
 - lib/jekyll/assets_plugin.rb
 - lib/jekyll/assets_plugin/asset_file.rb
@@ -153,14 +171,16 @@ files:
 - spec/fixtures/_assets/app.css.erb
 - spec/fixtures/_assets/app.js
 - spec/fixtures/_assets/noise.png
-- spec/fixtures/_assets/photos.css.sass
 - spec/fixtures/_assets/should_fail.css.erb
 - spec/fixtures/_assets/vapor.css
 - spec/fixtures/_assets/vapor.js
+- spec/fixtures/_assets/vendor/bourbon.css.sass
+- spec/fixtures/_assets/vendor/compass.css.sass
 - spec/fixtures/_config.yml
 - spec/fixtures/_layouts/default.html
 - spec/fixtures/_posts/2012-10-19-hello-world.md
 - spec/fixtures/index.html
+- spec/lib/jekyll-assets/bourbon_spec.rb
 - spec/lib/jekyll-assets/compass_spec.rb
 - spec/lib/jekyll/assets_plugin/asset_file_spec.rb
 - spec/lib/jekyll/assets_plugin/configuration_spec.rb
@@ -191,20 +211,22 @@ rubyforge_project:
 rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: jekyll-assets-0.2.2
+summary: jekyll-assets-0.2.3
 test_files:
 - spec/fixtures/.gitignore
 - spec/fixtures/_assets/app.css.erb
 - spec/fixtures/_assets/app.js
 - spec/fixtures/_assets/noise.png
-- spec/fixtures/_assets/photos.css.sass
 - spec/fixtures/_assets/should_fail.css.erb
 - spec/fixtures/_assets/vapor.css
 - spec/fixtures/_assets/vapor.js
+- spec/fixtures/_assets/vendor/bourbon.css.sass
+- spec/fixtures/_assets/vendor/compass.css.sass
 - spec/fixtures/_config.yml
 - spec/fixtures/_layouts/default.html
 - spec/fixtures/_posts/2012-10-19-hello-world.md
 - spec/fixtures/index.html
+- spec/lib/jekyll-assets/bourbon_spec.rb
 - spec/lib/jekyll-assets/compass_spec.rb
 - spec/lib/jekyll/assets_plugin/asset_file_spec.rb
 - spec/lib/jekyll/assets_plugin/configuration_spec.rb