jekyll_img 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f9a0ee86751118f5ed309e486751eede3ce4d5c3dad14ecbe7d695aefcc54ee
-  data.tar.gz: a42e9552fe07aadb4f24882280505f2b55fbeb5b4789e5cb27e7d2f8e9ec7e75
+  metadata.gz: 893b2811f139eeae284d17d29a4b9c6b8348aebaf7b5fd54015bda14316bea17
+  data.tar.gz: 58f626e32417dfa0790115903453b575cacbab46d312144f741dbec6b05eb458
 SHA512:
-  metadata.gz: ad481773b5aabb69f9e8a24c1c3477fa112298f10c9fd21f1f28c008eedb694991107532787c625a0ad736bea7baac2f23220494ad6b2e4b5b56471074bb88fe
-  data.tar.gz: efef2dd2953194241346f6b354f2429241b0c9d116b5251d97a79d9654d9323acfbb101d1a33ac8481635a365c269224f0bce242aa2e1062661e917a2ba5f0b7
+  metadata.gz: d43b8d2c08e13776f29fa59d56750369243909ad74cb4ff66add5050576d49e83cf53a997932f3bf12797fa0fc67ec2e65f9fa782c8a201323a92c0f6c004435
+  data.tar.gz: 0ee7e15f89ef2a4f9755b418bd26893edcd77b3cdaa7c3015b6923509d0a0b077b1700161be9aeef227bd8f7b9fd39067e57e527d5ade7787bab577912a77019

data/CHANGELOG.md

@@ -1,13 +1,42 @@
+# Change Log
+
+## 0.1.6 / 2023-08-10
+
+* `.webp` file type is assumed and no longer needs to be specified.
+  For example, instead of writing this:
+
+  ```html
+  {% img src="blah.webp" %}
+  ```
+
+  You can now write:
+
+  ```html
+  {% img src="blah" %}
+  ```
+
+
+## 0.1.5 / 2023-05-30
+
+* Updated dependencies
+
+
 ## 0.1.4 / 2023-04-02
-  * Added [`attribution` support](https://github.com/mslinn/jekyll_plugin_support#subclass-attribution).
-  * Fixed `style=' false'` that appeared when the `style` and `wrapper_style` attributes were not provided.
+
+* Added [`attribution` support](https://github.com/mslinn/jekyll_plugin_support#subclass-attribution).
+* Fixed `style=' false'` that appeared when the `style` and `wrapper_style` attributes were not provided.
+
 
 ## 0.1.3 / 2023-02-22
-  * Added `img/continue_on_error` configuration parameter.
+
+* Added `img/continue_on_error` configuration parameter.
+
 
 ## 0.1.2 / 2023-02-14
-  * Fixed `img_props.rb:91:in `size_unit_specified?': undefined method `end_with?' for false:FalseClass (NoMethodError)`
+
+* Fixed `img_props.rb:91:in `size_unit_specified?': undefined method `end_with?' for false:FalseClass (NoMethodError)`
 
 
 ## 0.1.1 / 2023-02-12
-  * Initial release
+
+* Initial release

data/README.md

@@ -1,51 +1,102 @@
-`jekyll_img`
-[![Gem Version](https://badge.fury.io/rb/jekyll_img.svg)](https://badge.fury.io/rb/jekyll_img)
-===========
+# `jekyll_img` [![Gem Version](https://badge.fury.io/rb/jekyll_img.svg)](https://badge.fury.io/rb/jekyll_img)
 
-`Jekyll_img` is a Jekyll plugin that displays images,
-and provides support for captions and URLs.
+
+`Jekyll_img` is a Jekyll plugin that embeds images in HTML documents, with alignment options,
+flexible resizing, default styling, overridable styling, an optional caption, and an optional URL.
+
+If you are not using `webp` images in your Jekyll website, this plugin is not for you.
+Please read the next section for details.
+If you have a use case that would benefit from expanding the supported file types,
+please describe your use case on the [issue tracker](https://github.com/mslinn/jekyll_img/issues/5).
 
 See [demo/index.html](demo/index.html) for examples.
 
+
+## Image Fallback
+
+This plugin provides support for the
+[`webp`](https://developers.google.com/speed/webp) image format,
+with a fallback to `png` format by using the HTML
+[`picture`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/picture) element.
+
+This means that 2 versions of every image are required: a `webp` version, and a `png` version.
+
+You specify the desired image with a `webp` filetype (or no filetype),
+and the plugin generates a `picture` element that contains a primary
+`source` sub-element that specifies the given image URL,
+and a secondary `img` sub-element with a [`png`](https://en.wikipedia.org/wiki/PNG) filetype.
+
+For example, these two invocations yield the same result:
+
+```html
+{% img src="blah" %}
+{% img src="blah.webp" %}
+```
+
+Would conceptually generate the following
+(to support the other options, the generated HTML can be a lot more complex):
+
+```html
+<picture>
+  <source srcset="blah.webp" type="image/webp" />
+  <source srcset="blah.png" type="image/png" />
+  <img src="blah.png" />
+</picture>
+```
+
+The above would fetch and display `blah.webp` if the web browser supported `webp` format,
+otherwise it would fetch and display `blah.png`.
+
+
+## Demo
+
 Run the demo website by typing:
+
 ```shell
 $ demo/_bin/debug -r
 ```
+
 ... and point your web browser to http://localhost:4444
 
 
 ## Usage
-    {% img [Options] src='path' %}
+
+```html
+{% img [Options] src='path' %}
+```
 
 `Options` are:
 
- - `attribution` See [`jekyll_plugin_support`](https://github.com/mslinn/jekyll_plugin_support#subclass-attribution).
- - `align="left|inline|right|center"` Default value is `inline`
- - `alt="Alt text"` Default value is the `caption` text, if provided
- - `caption="A caption"` No default value
- - `classes="class1 class2 classN"` Extra &lt;img&gt; classes; default is `rounded shadow`
- - `id="someId"` No default value
- - `nofollow`  Generates `rel='nofollow'`; only applicable when `url` is specified
- - `size='eighthsize|fullsize|halfsize|initial|quartersize|XXXYY|XXX%'`
+- `attribution` See [`jekyll_plugin_support`](https://github.com/mslinn/jekyll_plugin_support#subclass-attribution).
+- `align="left|inline|right|center"` Default value is `inline`
+- `alt="Alt text"` Default value is the `caption` text, if provided
+- `caption="A caption"` No default value
+- `classes="class1 class2 classN"` Extra &lt;img&gt; classes; default is `rounded shadow`
+- `id="someId"` No default value
+- `nofollow`  Generates `rel='nofollow'`; only applicable when `url` is specified
+- `size='eighthsize|fullsize|halfsize|initial|quartersize|XXXYY|XXX%'`
    Defines width of image.
-   - `initial` is the default behavior.
-   - `eighthsize`, `fullsize`, `halfsize`, and `quartersize` are relative to the enclosing tag's width.
-   - CSS units can also be used, for those cases `XXX` is a float and `YY` is `unit` (see below)
- - `style='css goes here'` CSS style for &lt;img&gt;; no default
- - `target='none|whatever'` Only applicable when `url` is specified; default value is `_blank`
- - `title="A title"` Default value is `caption` text, if provided
- - `url='https://domain.com'` No default value
- - `wrapper_class='class1 class2 classN'` Extra CSS classes for wrapper &lt;div&gt;; no default value
- - `wrapper_style='background-color: black;'` CSS style for wrapper &lt;div&gt;; no default value
+  - `initial` is the default behavior.
+  - `eighthsize`, `fullsize`, `halfsize`, and `quartersize` are relative to the enclosing tag's width.
+  - CSS units can also be used, for those cases `XXX` is a float and `YY` is `unit` (see below)
+- `style='css goes here'` CSS style for &lt;img&gt;; no default
+- `target='none|whatever'` Only applicable when `url` is specified; default value is `_blank`
+- `title="A title"` Default value is `caption` text, if provided
+- `url='https://domain.com'` No default value
+- `wrapper_class='class1 class2 classN'` Extra CSS classes for wrapper &lt;div&gt;; no default value
+- `wrapper_style='background-color: black;'` CSS style for wrapper &lt;div&gt;; no default value
 
 [`unit`](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Values_and_units#numbers_lengths_and_percentages) is one of: `Q`, `ch`, `cm`, `em`, `dvh`, `dvw`, `ex`, `in`, `lh`,
 `lvh`, `lvw`, `mm`, `pc`, `px`, `pt`, `rem`, `rlh`, `svh`, `svw`, `vb`,
 `vh`, `vi`, `vmax`, `vmin`, or `vw`.
 
-CSS classes referenced by the `jekyll_img` plugin are at the bottom of [demo/assets/css/style.css](demo/assets/css/style.css). CSS marker classes are included, so CSS selectors can be used for additional styling.
+CSS classes referenced by the `jekyll_img` plugin are at the bottom of
+[`demo/assets/css/style.css`](demo/assets/css/style.css).
+CSS marker classes are included, so CSS selectors can be used for additional styling.
 
 
 ## Configuration
+
 By default, any errors cause Jekyll to abort.
 You can allow Jekyll to continue by setting the following in `_config.yml`:
 
@@ -56,6 +107,7 @@ img:
 
 
 ## Design
+
 The most significant design issue was the decision that image size and formatting should not change
 whether it had a caption.
 HTML captions exist within a `<figure />` element, which also surrounds the image.
@@ -71,6 +123,7 @@ Handling all possible situations of these two scenarios would significantly rais
 
 
 ### Wrapper &lt;div /&gt;
+
 To make the plugin code more manageable,
 the plugin always encloses the generated HTML & CSS within a wrapper `<div />`.
 The wrapper allows for a simple, consistent approach regardless of whether a caption is generated or not.
@@ -78,7 +131,7 @@ The wrapper allows for a simple, consistent approach regardless of whether a cap
 The wrapper width is identical to the displayed image width.
 Within the wrapper `<div />`, the embedded `<img />` is displayed with `width=100%`.
 If a caption is required, the generated `<figure />` only makes the space taken by the generated HTML longer;
-the image width and height is not affected.
+the image&rsquo;s width and height are not affected.
 
 The wrapper will not exceed the width of the tag that encloses it if the `size` parameter has values `eighthsize`, `fullsize`, `halfsize`, `initial` or `quartersize`.
 
@@ -99,29 +152,28 @@ group :jekyll_plugins do
 end
 ```
 
-Also add it to `_config.yml`:
-```yaml
-plugins:
-  - jekyll_img
-```
-
 And then execute:
 
-    $ bundle install
+```shell
+$ bundle
+```
 
 
 ## Additional Information
+
 More information is available on
 [Mike Slinn&rsquo;s website](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html).
 
 
 ## Development
+
 After checking out the repo, run `bin/setup` to install dependencies.
 
 You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 
 To build and install this gem onto your local machine, run:
+
 ```shell
 $ bundle exec rake install
 jekyll_img 0.1.0 built to pkg/jekyll_img-0.1.0.gem.
@@ -129,6 +181,7 @@ jekyll_img (0.1.0) installed.
 ```
 
 Examine the newly built gem:
+
 ```shell
 $ gem info jekyll_img
 
@@ -145,28 +198,37 @@ jekyll_img (0.1.0)
 ```
 
 ### Testing
+
 Examine the output by running:
+
 ```shell
 $ demo/_bin/debug -r
 ```
+
 ... and pointing your web browser to http://localhost:4444/
 
 ### Unit Tests
+
 Either run `rspec` from Visual Studio Code's *Run and Debug* environment
 (<kbd>Ctrl</kbd>-<kbd>shift</kbd>-<kbd>D</kbd>) and view the *Debug Console* output,
 or run it from the command line:
+
 ```shell
 $ rspec
 ```
 
 ### Build and Push to RubyGems
+
 To release a new version,
-  1. Update the version number in `version.rb`.
-  2. Commit all changes to git; if you don't the next step might fail with an unexplainable error message.
-  3. Run the following:
-     ```shell
-     $ bundle exec rake release
-     ```
+
+1. Update the version number in `version.rb`.
+2. Commit all changes to git; if you don't the next step might fail with an unexplainable error message.
+3. Run the following:
+
+   ```shell
+   $ bundle exec rake release
+   ```
+
      The above creates a git tag for the version, commits the created tag,
      and pushes the new `.gem` file to [RubyGems.org](https://rubygems.org).
 

data/jekyll_img.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |spec|
   spec.authors = ['Mike Slinn']
   spec.email = ['mslinn@mslinn.com']
   spec.files = Dir['.rubocop.yml', 'LICENSE.*', 'Rakefile', '{lib,spec}/**/*', '*.gemspec', '*.md']
-  spec.homepage = 'https://mslinn.com/jekyll/3000-jekyll-plugins.html#jekyll_img'
+  spec.homepage = 'https://www.mslinn.com/jekyll_plugins/jekyll_img.html'
   spec.license = 'MIT'
   spec.metadata = {
     'allowed_push_host' => 'https://rubygems.org',
@@ -29,5 +29,5 @@ Gem::Specification.new do |spec|
   spec.version = JekyllImgVersion::VERSION
 
   spec.add_dependency 'jekyll', '>= 3.5.0'
-  spec.add_dependency 'jekyll_plugin_support', '~> 0.6.0'
+  spec.add_dependency 'jekyll_plugin_support', '>= 0.7.0'
 end

data/lib/img_props.rb

@@ -85,6 +85,9 @@ class ImgProperties
     @src = @src.to_s.strip
     raise ImgError, "The 'src' parameter was not specified", [] if @src.empty?
 
+    filetype = File.extname(URI(@src).path)
+    @src += '.webp' if filetype.empty?
+
     @src = "/assets/images/#{@src}" unless ImgProperties.local_path?(@src) || url?(@src)
   end
 

data/lib/jekyll_img/version.rb

@@ -1,3 +1,3 @@
 module JekyllImgVersion
-  VERSION = '0.1.4'.freeze
+  VERSION = '0.1.6'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_img
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - Mike Slinn
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-06 00:00:00.000000000 Z
+date: 2023-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -28,16 +28,16 @@ dependencies:
   name: jekyll_plugin_support
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.7.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.7.0
 description:
 email:
 - mslinn@mslinn.com
@@ -59,14 +59,14 @@ files:
 - spec/img_props_spec.rb
 - spec/jekyll_img_spec.rb
 - spec/spec_helper.rb
-homepage: https://mslinn.com/jekyll/3000-jekyll-plugins.html#jekyll_img
+homepage: https://www.mslinn.com/jekyll_plugins/jekyll_img.html
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   bug_tracker_uri: https://github.com/mslinn/jekyll_img/issues
   changelog_uri: https://github.com/mslinn/jekyll_img/CHANGELOG.md
-  homepage_uri: https://mslinn.com/jekyll/3000-jekyll-plugins.html#jekyll_img
+  homepage_uri: https://www.mslinn.com/jekyll_plugins/jekyll_img.html
   source_code_uri: https://github.com/mslinn/jekyll_img
 post_install_message: |2+