jekyll-assets 3.0.5 → 3.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: be115b8dd928002bfc074650cc9a62eec14a31df
-  data.tar.gz: 344c3bf4f6e574e16fd73d291a96aca5fc4cff25
+SHA256:
+  metadata.gz: d245aff52390866323d9c7bf20d14fe63c28a0a95ae7fe535f3c6df506e7f7a5
+  data.tar.gz: 85d98b9f5543ea588fd5acf51d801ad98be4fa8e5b2998b6b5a279f3fdcddd46
 SHA512:
-  metadata.gz: ef800a9dd7e4052f0719990340d05147d48346e583a25e8887a4f1c3196d070deb078ba3142e465378b4549dba960d985d5ecea7ec8dafeb2da39994e3d1faa1
-  data.tar.gz: b6ed70b962068a68712492f40059d4b473bb259125de100f7ad94229927d3def67854d2938b6f0320b79288eb47481a4d04a57cc2df6b4adf5e2a01a6f1d0a84
+  metadata.gz: 92544fcdb40ca56d6b76a77e11faa199e7f2da477d597658673e504136a30ac54198dcddda36682803c6dc95ea1ded0193fbb82105210a297523e8b230ddcc00
+  data.tar.gz: 074e304b51a467c634c80acb05c600b698ba426e27a75f5794fb71af8968bda65979619ef1e8286c8fd543c8e4180d5ca04a4d8f434e5905451abfdfb44b0661

data/Gemfile

@@ -1,5 +1,5 @@
 # Frozen-string-literal: true
-# Copyright: 2012 - 2017 - MIT License
+# Copyright: 2012 - 2018 - MIT License
 # Encoding: utf-8
 
 source "https://rubygems.org"
@@ -38,4 +38,5 @@ group :optionals do
   gem "mini_magick", "~> 4.2", require: false
   gem "babel-transpiler", require: false
   gem "bootstrap", require: false
+  gem "sassc", require: false
 end

data/LICENSE

@@ -1,5 +1,5 @@
 Copyright (c) 2012 - 2015 Aleksey V Zapparov (http://ixti.net/)
-Copyright (c) 2015 - 2017 Jordon Bedwell (https://envygeeks.io)
+Copyright (c) 2015 - 2018 Jordon Bedwell (https://envygeeks.io)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,5 +1,5 @@
 [![Code Climate](https://img.shields.io/codeclimate/maintainability/envygeeks/jekyll-assets.svg?style=for-the-badge)](https://codeclimate.com/github/envygeeks/jekyll-assets/maintainability)
-[![Code Climate](https://img.shields.io/codeclimate/coverage/github/envygeeks/jekyll-assets.svg?style=for-the-badge)](https://codeclimate.com/github/envygeeks/jekyll-assets/test_coverage)
+[![Code Climate](https://img.shields.io/codeclimate/c/envygeeks/jekyll-assets.svg?style=for-the-badge)](https://codeclimate.com/github/envygeeks/jekyll-assets/coverage)
 [![Travis CI](https://img.shields.io/travis/envygeeks/jekyll-assets/master.svg?style=for-the-badge)](https://travis-ci.org/envygeeks/jekyll-assets)
 [![Donate](https://img.shields.io/badge/-DONATE-yellow.svg?style=for-the-badge)](https://www.paypal.com/donate/?token=2YE-4wLE2dSgtPaQqTlQgcD2BvKv_tkHUD7GJYs4OskLI0l6XFEAKpNc5rIG6-bAeMFdom)
 ![Gem Version](https://img.shields.io/gem/v/jekyll-assets.svg?style=for-the-badge)
@@ -7,9 +7,9 @@
 
 # Jekyll Assets
 
-Jekyll Assets is a drop in [asset pipeline](http://guides.rubyonrails.org/asset_pipeline.html) that uses [Sprockets](https://github.com/rails/sprockets) to build specifically for Jekyll. It utilizes [Sprockets](https://github.com/rails/sprockets), and [Jekyll](https://jekyllrb.com) to try and achieve a clean and extensible assets platform that supports plugins, caching, converting your assets, and even the proxy of said assets in a way that does not interfere with either [Sprockets](https://github.com/rails/sprockets), or [Jekyll](3), and your own source.  By default you can add Jekyll Assets to your Gemfile, as a plugin, and have it act as a drop-in replacement for Jekyll's basic SASS/CoffeeScript processors, with you only having to add it to your Gemfile, and updating your `<img>`, and `<link>`.
+Jekyll Assets is a drop in [asset pipeline](http://guides.rubyonrails.org/asset_pipeline.html) that uses [Sprockets](https://github.com/rails/sprockets) to build specifically for Jekyll. It utilizes [Sprockets](https://github.com/rails/sprockets), and [Jekyll](https://jekyllrb.com) to try and achieve a clean, and extensible assets platform that supports plugins, caching, converting your assets. It even supports proxying of said assets in a way that does not interfere with either [Sprockets](https://github.com/rails/sprockets), or [Jekyll](https://jekyllrb.com), or your own source.  By default you can add Jekyll Assets to your Gemfile, as a plugin, and have it act as a drop-in replacement for Jekyll's basic SASS processors, with you only having to add it to your Gemfile, and updating your `<img>`, and `<link>`.
 
-## Using Jekyll Assets with Jekyll
+## Installing
 
 ```ruby
 gem "jekyll-assets", group: :jekyll_plugins
@@ -17,13 +17,17 @@ gem "jekyll-assets", git: "https://github.com/envygeeks/jekyll-assets", group: :
 gem "jekyll-assets", "~> x.x.alpha", group: :jekyll_plugins
 ```
 
-### Requirments
+---
 
-* Ruby ***2.3+***
-* Jekyll ***3.5+***
-* Sprockets ***3.3+***
+### System Requirements
 
-***If you would like SourceMap support, or faster Sprockets, you should prefer to use Sprockets "~> 4.0.beta", we support SourceMaps in this version of Sprockets because it supports them. It's manifest an other features are also much better inside of this version of Sprockets.***
+* `ruby`: ***2.3+***
+* `sprockets`: ***3.3+***
+* `jekyll`: ***3.5+***
+
+---
+
+If you'd like SourceMaps, or *faster* Sprockets, opt to use Sprockets `4.0`, you can use it by placing it to your Gemfile.
 
 ```ruby
 gem "sprockets", "~> 4.0.beta", {
@@ -33,7 +37,7 @@ gem "sprockets", "~> 4.0.beta", {
 
 ## Configuration
 
-The configuration file is the same as Jekyll's, which is `_config.yml`. Except we use the special key "assets" inside of that file.  Any environment variable noted as "val on `JEKYLL_ENV`" is only overridden when not explicitly set.  All values listed below are default, you need not copy these into your configuration file unless you plan to change a value.
+The configuration file is the same as Jekyll's, which is `_config.yml`. Except we use the special key called `assets` inside of that file. All values listed below are default, you need not copy these into your configuration file unless you plan to change a value. *Setting a value makes it explicit, and shared across both **production**, and **development**.*
 
 ```yaml
 source_maps: true # false on JEKYLL_ENV=production
@@ -72,59 +76,50 @@ cdn:
 #   Only use this if you have more.
 # --
 sources:
-- assets/css
-- assets/fonts
-- assets/images
-- assets/videos
-- assets/javascript
-- assets/video
-- assets/image
-- assets/img
-- assets/js
-- _assets/css
-- _assets/fonts
-- _assets/images
-- _assets/videos
-- _assets/javascript
-- _assets/video
-- _assets/image
-- _assets/img
-- _assets/js
-- css
-- fonts
-- images
-- videos
-- javascript
-- video
-- image
-- img
-- js
+  - assets/css
+  - assets/fonts
+  - assets/images
+  - assets/videos
+  - assets/javascript
+  - assets/video
+  - assets/image
+  - assets/img
+  - assets/js
+  - _assets/css
+  - _assets/fonts
+  - _assets/images
+  - _assets/videos
+  - _assets/javascript
+  - _assets/video
+  - _assets/image
+  - _assets/img
+  - _assets/js
+  - css
+  - fonts
+  - images
+  - videos
+  - javascript
+  - video
+  - image
+  - img
+  - js
 plugins:
   css: { autoprefixer: {}}
   img: { optim: {}}
 ```
 
-## Tag
-### Usage
-#### Liquid
+## Tag `{% asset %}`, `<img>`
 
-```liquid
+```html
 {% asset src @magick:2x alt='This is my alt' %}
 {% asset src @magick:2x alt='This is my alt' %}
-```
-
-#### HTML
-
-```html
 <img src="src" asset="@magick:2x" alt="This is my alt">
 <img src="src" alt="This is my alt" asset>
 ```
 
-### Defaults
-
-We provide several defaults that get set when you run an asset, depending on content type, this could be anything from type, all the way to integrity.  If there is a default attribute you do not wish to be included, you can disable the attribute with `!attribute`, and it will be skipped over.
+## Defaults
 
-#### Usage
+We provide several defaults that get set when you run an asset, depending on content type, this could be anything from type, all the way to integrity.  *If there is a default attribute you do not wish to be included, you can disable the attribute with `!attribute`, and it will be skipped over.*
 
 ```liquid
 {% asset img.png !integrity %}
@@ -135,7 +130,7 @@ We provide several defaults that get set when you run an asset, depending on con
 
 Our tags will take any number of arguments, and convert them to HTML, and even attach them to your output if the HTML processor you use accepts that kind of data.  ***This applies to anything but hashes, and arrays.*** So adding say, a class, or id, is as easy as doing `id="val"` inside of your tag arguments.
 
-#### Builtins
+#### Built In
 
 | Arg | Description | Type | Return Type |
 |---|---|---|---|
@@ -148,7 +143,7 @@ Our tags will take any number of arguments, and convert them to HTML, and even a
 | `srcset` | [Responsive]() `<img>` | `image/*` | `text/html` |
 | `srcset` + `@pic` | [Responsive]() `<pic>` | `image/*` | `text/html` |
 
-***Jekyll Assets uses [@envygeeks](https://github.com/envygeeks) `liquid-tag-parser` which supports advanced arguments (hash based arguments) as well as array based arguments.  When you see something like `k1:sk1=val` it will get converted to `k1 = { sk1: "val" }` in Ruby.  To find out more about how we process tags you should visit the documentation for [`liquid-tag-parser`](https://github.com/envygeeks/liquid-tag-parser)***
+*Jekyll Assets uses [@envygeeks](https://github.com/envygeeks) `liquid-tag-parser` which supports advanced arguments (hash based arguments) as well as array based arguments.  When you see something like `k1:sk1=val` it will get converted to `k1 = { sk1: "val" }` in Ruby.  To find out more about how we process tags you should visit the documentation for [`liquid-tag-parser`](https://github.com/envygeeks/liquid-tag-parser)*
 
 #### Responsive Images
 
@@ -198,29 +193,38 @@ Jekyll Assets has the concept of responsive images, using the `picture` (when us
 
 ##### Args
 
-| Arg | Type | Description | `@pic` Only |
-| --- | ---- | ------------| ----------- |
-| `width`     | Width [Density] | Resize, set `srcset="<Src> <<Width>px/Density>"` | ✗ |
-| `min-width` | Width [Density] | Resize, set `media="(min-width: <Width>px)"` | ✔ |
-| `max-width` | Width [Density] | Resize, set `media="(max-width: <Width>px)"` | ✔ |
-| `sizes`     | Any | Your value, unaltered, unparsed. | ✗ |
-| `media`     | Any | Your value, unaltered, unparsed. | ✗ |
+| Arg         | Type            | Description                              | `@pic` Only |
+| ----------- | --------------- | ---------------------------------------- | ----------- |
+| `width`     | Width [Density] | Resize, set `srcset="<Src> <<Width>px/Density>"` | ✗           |
+| `min-width` | Width [Density] | Resize, set `media="(min-width: <Width>px)"` | ✔           |
+| `max-width` | Width [Density] | Resize, set `media="(max-width: <Width>px)"` | ✔           |
+| `sizes`     | Any             | Your value, unaltered, unparsed.         | ✗           |
+| `media`     | Any             | Your value, unaltered, unparsed.         | ✗           |
 
-***If you set `media`, w/ `max-width`, `min-width`, we will not ship `media`, we will simply resize and assume you know what you're doing.  Our parser is not complex, and does not make a whole lot of assumptions on your behalf, it's simple and only meant to make your life easier.  In the future we may make it more advanced.***
+*If you set `media`, w/ `max-width`, `min-width`, we will not ship `media`, we will simply resize and assume you know what you're doing.  Our parser is not complex, and does not make a whole lot of assumptions on your behalf, it's simple and only meant to make your life easier.  In the future we may make it more advanced.*
 
 ## Liquid
 
-We support liquid arguments for tag values (but not tag keys), and we also support Liquid pre-processing (with your Jekyll context) of most files if they end with `.liquid`.  This will also give you access to our filters as well as their filters, and Jekyll's filters.
-
-### Usage
+We support liquid arguments for tag values (but not tag keys), and we also support Liquid pre-processing (with your Jekyll context) of most files if they end with `.liquid`.  This will also give you access to our filters as well as their filters, and Jekyll's filters, and any tags that are globally available.
 
 ```liquid
-{% img '{{ image_path }}' %}
-{% img '{{ image_path }}' proxy:key='{{ value }}' %}
-{% img {{\ image_path\ }} %}
+{% asset '{{ site.bg_img }}' %}
+{% asset '{{ site.bg_img }}' proxy:key='{{ value }}' %}
+{% asset {{\ site.bg_img\ }} %}
+```
+
+### `.sass`, `.scss`
+
+```scss
+body {
+  background-image: asset_url("'{{ site.bg_img }}'");
+  background-image: asset_url("'{{ site.bg_img }}' proxy:key='{{ value }}'");
+  background-image: asset_url("{{\ site.bg_img\ }}");
+}
 ```
 
-#### `.liquid.ext`, and `.ext.liquid`
+### `.liquid.ext`
+### `.ext.liquid`
 
 ```scss
 .bg {
@@ -228,18 +232,16 @@ We support liquid arguments for tag values (but not tag keys), and we also suppo
 }
 ```
 
-You have full access to your entire Jekyll context from any liquid
-processing we do, so you can do whatever you like, and be as dynamic as you like, including full loops, and conditional Liquid based CSS/JavaScript since we pre-process your text files. ***On Sprockets 4.x you can use `.liquid.ext` and `.ext.liquid`, but because of the way Sprockets 3.x works, we have opted to only allow the default extension of `.ext.liquid` when running on "Old Sprockets" (AKA 3.x.)  If you would like Syntax + Liquid you should opt to install Sprockets 4.x so you can get the more advanced features.***
+You have full access to your entire global context from any liquid
+processing we do.  Depending on where you do it, you might or might not also have access to your local (page) context as well. You can also do whatever you like, and be as dynamic as you like, including full loops, and conditional Liquid, since we pre-process your text files. *On Sprockets 4.x you can use `.liquid.ext` and `.ext.liquid`, but because of the way Sprockets 3.x works, we have opted to only allow the default extension of `.ext.liquid` when running on "Old Sprockets" (AKA 3.x.)  If you would like Syntax + Liquid you should opt to install Sprockets 4.x so you can get the more advanced features.*
 
-##### Importing
+#### Importing
 
 ***In order to import your Liquid pre-processed assets inside of Liquid or JS you should use a Sprockets `//require=`, Sprockets does not integrate that deeply into JavaScript and SASS to allow you to `@import` and pre-process.***
 
-## Sass/SCSS Helpers
-
-We provide two helpers, `asset_path` to return the path of an asset, and `asset_url` which will wrap `asset_path` into a `url()` for you, making it easy for you to extract your assets and their paths inside of SCSS.
+## `.sass`, `.scss` Helpers
 
-### Usage
+We provide two base helpers, `asset_path` to return the path of an asset, and `asset_url` which will wrap `asset_path` into a `url()` for you, making it easy for you to extract your assets and their paths inside of SCSS.  All other helpers that Sprockets themselves provide will use our `asset_path` helper, so you can use them like normal, *including with Liquid*
 
 ```scss
 body {
@@ -247,11 +249,9 @@ body {
 }
 ```
 
-#### Proxies, and Other Arguments
+### Proxies, and Other Arguments
 
-Any argument that is supported by our regular tags, is also supported by our Sass/SCSS helpers, with a few obvious exceptions (like `srcset`).  This means that you can wrap your assets into `magick` if you wish, or `imageoptim` or any other proxy that is able to spit out a path for you to use.
-
-##### Usage
+Any argument that is supported by our regular tags, is also supported by our `.sass`/`.scss` helpers, with a few obvious exceptions (like `srcset`).  This means that you can wrap your assets into `magick` if you wish, or `imageoptim` or any other proxy that is able to spit out a path for you to use.  The general rule is, that if it returns a path, or `@data` then it's safe to use within `.scss`/`.sass`, otherwise it will probably throw.
 
 ```scss
 body {
@@ -259,11 +259,11 @@ body {
 }
 ```
 
-***Not we do not validate your arguments, so if you send a conflicting argument that results in invalid CSS, you are responsible for that, in that if you ship us `srcset` we won't throw, we will spit out HTML for you, and it will break your CSS, this is by design.***
+*Note: we do not validate your arguments, so if you send a conflicting argument that results in invalid CSS, you are responsible for that, in that if you ship us `srcset` we might or might not throw, depending on how the threads are ran. So it might ship HTML if you do it wrong, and it will break your CSS, this is by design so that if possible, in the future, we can allow more flexibility, or so that plugins can change based on arguments.*
 
 ## List
 
-We provide all *your* assets as a hash of Liquid Drops so you can get basic info that we wish you to have access to without having to prepare the class.
+We provide all *your* assets as a hash of Liquid Drops so you can get basic info that we wish you to have access to without having to prepare the class. **Note:** The keys in the `assets` array are the names of the original files, e.g., use `*.scss` instead of `*.css`.
 
 ```liquid
 {{ assets["bundle.css"].content_type }} => "text/css"
@@ -273,13 +273,14 @@ We provide all *your* assets as a hash of Liquid Drops so you can get basic info
 
 The current list of available accessors:
 
-| Method | Description |
-|---|---|
-| `content_type` | The RFC content type |
-| `height` | The asset height ***(if available)*** |
-| `filename` | The full path to the assets actual file |
-| `width` | The asset width ***(if available)*** |
-| `digest_path` | The prefixed path |
+| Method         | Description                             |
+| -------------- | --------------------------------------- |
+| `content_type` | The RFC content type                    |
+| `height`       | The asset height ***(if available)***   |
+| `filename`     | The full path to the assets actual file |
+| `width`        | The asset width ***(if available)***    |
+| `digest_path`  | The prefixed path                       |
+| `integrity`    | The SRI hash (currently sha256)         |
 
 ### Looping
 
@@ -355,15 +356,15 @@ We have basic support for WebComponents when using Sprockets `~> 4.0.0.beta`, th
 
 ## Hooks
 
-| Point | Name | Instance | Args |
-|---|---|---|---|
-| `:env` | `:before_init` | ✔ | ✗ |
-| `:env` | `:after_init` | ✔ | ✗ |
-| `:env` | `:after_write` | ✔ | ✗ |
-| `:config` | `:before_merge` | ✗ | `Config{}` |
-| `asset` | `:before_compile` | ✗ | `Asset`, `Manifest` |
+| Point     | Name              | Instance | Args                |
+| --------- | ----------------- | -------- | ------------------- |
+| `:env`    | `:before_init`    | ✔        | ✗                   |
+| `:env`    | `:after_init`     | ✔        | ✗                   |
+| `:env`    | `:after_write`    | ✔        | ✗                   |
+| `:config` | `:before_merge`   | ✗        | `Config{}`          |
+| `asset`   | `:before_compile` | ✗        | `Asset`, `Manifest` |
 
-### Usage
+### Example
 
 ```ruby
 Jekyll::Assets::Hook.register :env, :before_init do
@@ -387,8 +388,6 @@ end
 
 Your plugin can also register it's own hooks on our Hook system, so that you can trigger hooks around your stuff as well, this is useful for extensive plugins that want more power.
 
-##### Usage
-
 ```ruby
 Jekyll::Assets::Hook.add_point(:plugin, :hook)
 ```
@@ -402,28 +401,25 @@ end
 
 ## Default Plugins
 ### Font Awesome
-#### Installation
 
 ```ruby
 gem "font-awesome-sass"
 ```
 
-#### Usage
-
 ```scss
-@import "font-awesome-sprockets"
-@import "font-awesome"
+@import "font-awesome-sprockets";
+@import "font-awesome";
+html {
+  // ...
+}
 ```
 
 ### CSS Auto-Prefixing
-#### Installation
 
 ```ruby
 gem "autoprefixer-rails"
 ```
 
-#### Config
-
 ```yml
 assets:
   autoprefixer:
@@ -433,61 +429,52 @@ assets:
 ```
 
 ### Bootstrap
-#### Installation
-
-***4.x***
-```ruby
-gem "bootstrap"
-```
 
-***3.x***
 ```ruby
-gem "boostrap-sass"
+gem "boostrap-sass" # 3.x
+gem "bootstrap"     # 4.x
 ```
 
-#### Usage
-
 ```scss
 @import 'bootstrap'
+html {
+  // ...
+}
 ```
 
 ### ImageMagick
-#### Installation
 
 ```ruby
 gem "mini_magick"
 ```
 
-#### Tag Args
+#### Args
 
 See the [MiniMagick docs](https://github.com/minimagick/minimagick#usage)
 to get an idea what `<value>` can be.
 
-| Name | Accepts Value |
-|---|---|
-| `magick:compress` | ✔ |
-| `magick:resize` | ✔ |
-| `magick:format`<sup>*</sup> | ✔ |
-| `magick:quality` | ✔ |
-| `magick:rotate` | ✔ |
-| `magick:gravity` | ✔ |
-| `magick:crop` | ✔ |
-| `magick:flip` | ✔ |
-| `@magick:double` | ✗ |
-| `@magick:half` | ✗ |
-
-<sup>\*</sup> ***`magick:format` requires an ext or a valid MIME content type like `image/jpeg` or `.jpg`.  We will `ImageMagick -format` on your behalf with that information by getting the extension.***
+| Name                        | Accepts Value |
+| --------------------------- | ------------- |
+| `magick:compress`           | ✔             |
+| `magick:resize`             | ✔             |
+| `magick:format`<sup>*</sup> | ✔             |
+| `magick:quality`            | ✔             |
+| `magick:rotate`             | ✔             |
+| `magick:gravity`            | ✔             |
+| `magick:crop`               | ✔             |
+| `magick:flip`               | ✔             |
+| `@magick:double`            | ✗             |
+| `@magick:half`              | ✗             |
+
+<sup>\*</sup> *`magick:format` requires an ext or a valid MIME content type like `image/jpeg` or `.jpg`.  We will `ImageMagick -format` on your behalf with that information by getting the extension.*
 
 ### ImageOptim
-#### Installation
 
 ```ruby
 gem "image_optim"
 ```
 
-#### Config
-
-  Check the [ImageOptim](https://github.com/toy/image_optim#configuration) to get idea about configuration options.
+Check the [ImageOptim](https://github.com/toy/image_optim#configuration) to get idea about configuration options.
 
 ```yml
 assets:
@@ -505,27 +492,27 @@ assets:
             strategy: 4
 ```
 
-#### Tag Args
+#### Args
 
-| Name | Accepts Value |
-|---|---|
-| `@image_optim:preset`<sup>*</sup> | ✗ |
+| Name                              | Accepts Value |
+| --------------------------------- | ------------- |
+| `@image_optim:preset`<sup>*</sup> | ✗             |
 
 <sup>\*</sup>***Where `preset` is the name of the preset.***
 
 ### Building Your Own Plugins
-#### Global Instance Vars
+#### Globals
 
-| Name | Class |
-|---|---|
-| `@env` | `Jekyll::Assets::Env` |
-| `@args` | `Liquid::Tag::Parser{}` |
-| `@jekyll` | `Jekyll::Site` |
-| `@asset` | `Sprockets::Asset` |
+| Name      | Class                   |
+| --------- | ----------------------- |
+| `@env`    | `Jekyll::Assets::Env`   |
+| `@args`   | `Liquid::Tag::Parser{}` |
+| `@jekyll` | `Jekyll::Site`          |
+| `@asset`  | `Sprockets::Asset`      |
 
-##### HTML Instance Vars
+#### HTML
 
-| Name | Class | Type |
-|---|---|---|
+| Name   | Class                      | Type            |
+| ------ | -------------------------- | --------------- |
 | `@doc` | `Nokogiri:: XML::Document` | `image/svg+xml` |
-| `@doc` | `Nokogiri::HTML::Document` | `image/*` |
+| `@doc` | `Nokogiri::HTML::Document` | `image/*`       |