jekyll_picture_tag 1.10.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13254626160df11fadc7fe2222b17a7fa96c578a5874529b77e84bf0b99e482d
-  data.tar.gz: 2a9bbcfaf2d048726ce75c5177b7fa051c65310ff2cf86414b1bae44a3436974
+  metadata.gz: 46fd8634e4d9eff8493b340560d84e8a398eb77db81a511529f0b670f111de7c
+  data.tar.gz: 103f00baec1839e018094b5c3d3522ecff13849e3bda46353ddde9e70e2040fb
 SHA512:
-  metadata.gz: 7137ec91ead7245fd8c869a72b4855d335b5d32c9bd56e2f4fbf81e7f168ff0fc28520482ee5eb62969a73148c6ff31baeae4338c1e6baf1e0f48764b27b9e2d
-  data.tar.gz: b174de6bd9135a003240f56652f2d6ebfaf13c4ce0ce909c91b99d82cfde8ce53f6e5da916aba5842e6c6c50f069f2f0bc74c667bbd576df921dd89dde950251
+  metadata.gz: 14afd21d6a1cd36bac48b20e79047e1df845b458e763d0eb590125fa45dd2eef431cc27836f22073878d807dc5118787f40fe8b2ffc15579bd6edf4c70f0411b
+  data.tar.gz: bd9131318cd312b340ff337db88127c9b8b14f78c2bfc64ec04dd6f9d27db87a08d36a59bf5aa550f51ede5c2a6b9cdda8554c60f2cecc64db5e914a1f28a84f

data/.rubocop.yml

@@ -1,2 +1,81 @@
+# Disabled
 Style/FrozenStringLiteralComment:
   Enabled: false
+
+Style/StringConcatenation:
+  Enabled: false
+
+# New cops, enabled. We aren't using the 'NewCops' setting because then rubocop
+# updates can break our CI.
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+Lint/BinaryOperatorWithIdenticalOperands:
+  Enabled: true
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+Lint/DuplicateElsifCondition:
+  Enabled: true
+Lint/DuplicateRescueException:
+  Enabled: true
+Lint/EmptyConditionalBody:
+  Enabled: true
+Lint/FloatComparison:
+  Enabled: true
+Lint/MissingSuper:
+  Enabled: true
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+Lint/OutOfRangeRegexpRef:
+  Enabled: true
+Lint/RaiseException:
+  Enabled: true
+Lint/SelfAssignment:
+  Enabled: true
+Lint/StructNewOverride:
+  Enabled: true
+Lint/TopLevelReturnWithArgument:
+  Enabled: true
+Lint/UnreachableLoop:
+  Enabled: true
+Style/AccessorGrouping:
+  Enabled: true
+Style/ArrayCoercion:
+  Enabled: true
+Style/BisectedAttrAccessor:
+  Enabled: true
+Style/CaseLikeIf:
+  Enabled: true
+Style/ExplicitBlockArgument:
+  Enabled: true
+Style/ExponentialNotation:
+  Enabled: true
+Style/GlobalStdStream:
+  Enabled: true
+Style/HashAsLastArrayItem:
+  Enabled: true
+Style/HashEachMethods:
+  Enabled: true
+Style/HashLikeCase:
+  Enabled: true
+Style/HashTransformKeys:
+  Enabled: true
+Style/HashTransformValues:
+  Enabled: true
+Style/OptionalBooleanParameter:
+  Enabled: true
+Style/RedundantAssignment:
+  Enabled: true
+Style/RedundantFetchBlock:
+  Enabled: true
+Style/RedundantFileExtensionInRequire:
+  Enabled: true
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+Style/RedundantRegexpEscape:
+  Enabled: true
+Style/SingleArgumentDig:
+  Enabled: true
+Style/SlicingWithRange:
+  Enabled: true

data/docs/Gemfile

@@ -1,4 +1,6 @@
 source 'https://rubygems.org'
 
-gem 'github-pages', group: :jekyll_plugins
-gem 'jekyll-theme-slate'
+group :jekyll_plugins do
+  gem 'github-pages'
+  gem 'jekyll-rtd-theme'
+end

data/docs/Gemfile.lock

@@ -1,7 +1,7 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3)
+    activesupport (6.0.3.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
@@ -28,12 +28,12 @@ GEM
     execjs (2.7.0)
     faraday (1.0.1)
       multipart-post (>= 1.2, < 3)
-    ffi (1.12.2)
+    ffi (1.13.1)
     forwardable-extended (2.6.0)
     gemoji (3.0.1)
-    github-pages (204)
+    github-pages (206)
       github-pages-health-check (= 1.16.1)
-      jekyll (= 3.8.5)
+      jekyll (= 3.8.7)
       jekyll-avatar (= 0.7.0)
       jekyll-coffeescript (= 1.1.1)
       jekyll-commonmark-ghpages (= 0.1.6)
@@ -72,7 +72,7 @@ GEM
       mercenary (~> 0.3)
       minima (= 2.5.1)
       nokogiri (>= 1.10.4, < 2.0)
-      rouge (= 3.13.0)
+      rouge (= 3.19.0)
       terminal-table (~> 1.4)
     github-pages-health-check (1.16.1)
       addressable (~> 2.3)
@@ -80,13 +80,13 @@ GEM
       octokit (~> 4.0)
       public_suffix (~> 3.0)
       typhoeus (~> 1.3)
-    html-pipeline (2.12.3)
+    html-pipeline (2.13.0)
       activesupport (>= 2)
       nokogiri (>= 1.4)
     http_parser.rb (0.6.0)
     i18n (0.9.5)
       concurrent-ruby (~> 1.0)
-    jekyll (3.8.5)
+    jekyll (3.8.7)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
@@ -136,6 +136,8 @@ GEM
       addressable (~> 2.0)
       jekyll (>= 3.5, < 5.0)
       rubyzip (>= 1.3.0)
+    jekyll-rtd-theme (0.1.6)
+      github-pages (~> 206)
     jekyll-sass-converter (1.5.2)
       sass (~> 3.4)
     jekyll-seo-tag (2.6.1)
@@ -202,9 +204,9 @@ GEM
       jekyll (>= 3.5, < 5.0)
       jekyll-feed (~> 0.9)
       jekyll-seo-tag (~> 2.1)
-    minitest (5.14.0)
+    minitest (5.14.1)
     multipart-post (2.1.1)
-    nokogiri (1.10.9)
+    nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
     octokit (4.18.0)
       faraday (>= 0.9)
@@ -215,7 +217,7 @@ GEM
     rb-fsevent (0.10.4)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    rouge (3.13.0)
+    rouge (3.19.0)
     ruby-enum (0.8.0)
       i18n
     rubyzip (2.3.0)
@@ -236,14 +238,14 @@ GEM
     tzinfo (1.2.7)
       thread_safe (~> 0.1)
     unicode-display_width (1.7.0)
-    zeitwerk (2.3.0)
+    zeitwerk (2.4.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   github-pages
-  jekyll-theme-slate
+  jekyll-rtd-theme
 
 BUNDLED WITH
    2.1.4

data/docs/_config.yml

@@ -1,13 +1,9 @@
-theme: jekyll-theme-slate
+remote_theme: rundocs/jekyll-rtd-theme
+
 title: Jekyll Picture Tag
+description: Images for Jekyll, done correctly.
+lang: en-US
 
-url: ''
 baseurl: '/jekyll_picture_tag'
-
-defaults:
-  - 
-    scope: 
-      path: ''
-    values:
-      layout: directory
-  
+readme_index: 
+  with_frontmatter: true

data/docs/devs/contributing/code.md

@@ -0,0 +1,44 @@
+---
+sort: 4
+---
+
+# Code Guidelines
+
+* Generally, go for straightforward and readable rather than terse and clever. I'm not actually a
+  very good programmer; I need simple code that's easy to understand.
+
+* Refactoring is welcome, especially in the name of the previous point.
+
+* I'm very reluctant to introduce breaking changes to configuration settings. This rule isn't
+  absolute, but I'm not going to do it without a good reason.
+
+* Don't disable cops without strong justification.
+
+* I generally try to write tests before writing code, especially when fixing bugs. This
+  gives us some confidence that what we think we're testing and what we're actually testing aren't
+  too different.
+
+## Hard rules
+
+These aren't the rules for submitting a pull request, these are the rules for merging into master.
+I'm thrilled to receive any help at all, and I'm more than happy to help with meeting these
+criteria:
+
+* Liquid tag syntax can only be extended; no breaking changes. I'm not willing to force
+  users to dig through their entire site and change every picture tag in order to update to the
+  latest version.
+
+* Maintain "no configuration required" - a new user must be able to add JPT to their gemfile, bundle
+  install, and start writing picture tags in their site without touching a yml file.
+
+* 100% test coverage (Meaning that when running the unit and integration tests together, every line
+  of code in the `lib` folder must run at least once.)
+
+* No failing tests
+
+* No rubocop warnings
+
+### Thanks!
+
+As I said, don't let any of the rules & guidelines scare you away. They're the rules for merging
+into master, not submitting a pull request. I'm thrilled to receive any help at all.

data/docs/devs/contributing/docs.md

@@ -0,0 +1,13 @@
+---
+sort: 2
+---
+
+# Docs
+
+They run on github pages, which is based on jekyll. You can preview as you edit:
+
+0. Follow the [setup instructions](setup)
+1. `$ cd docs`
+2. `$ bundle install`
+3. `$ bundle exec jekyll serve`
+4. In a web browser, navigate to `localhost:4000/jekyll_picture_tag/`

data/docs/devs/contributing/index.md

@@ -0,0 +1,15 @@
+---
+---
+# Contributing
+
+Bug reports, feature requests, and feedback are very welcome, either through
+github issues or via email: robert@buchberger.cc 
+
+Pull requests are encouraged! I'm happy to answer questions and provide
+assistance along the way.  Don't let any of the recommendations/requests in this
+guide stop you from submitting one.
+
+I think one of the biggest opportunities for improvement in this plugin is its
+documentation. I'd really love help here, and all you need to know is markdown.
+
+{% include list.liquid %}

data/docs/devs/contributing/setup.md

@@ -0,0 +1,13 @@
+---
+sort: 1
+---
+
+## Setup
+
+It's pretty standard:
+
+```
+$ git clone git@github.com:rbuchberger/jekyll_picture_tag.git
+$ cd jekyll_picture_tag
+$ bundle install
+```

data/docs/devs/contributing/testing.md

@@ -0,0 +1,41 @@
+---
+sort: 3
+---
+
+## How to run the tests
+
+You probably only need to use docker if it's inconvenient to install ImageMagick 7.
+
+### Bare Metal
+
+```note
+Depending on your environment, you may need to prefix all rake commands with
+`bundle exec`.
+```
+
+`rake test` runs the test suite (both unit tests and integration tests). Ignore the mini_magick
+`method redefined` warnings (unless you know how to fix them?) 
+
+`rake unit` runs just the unit tests, while `rake integration` runs the integration tests. The unit
+test coverage isn't stellar, but both unit and integration tests together hit 100%.
+
+Speaking of coverage, simplecov is set up -- you'll get a measurement of coverage in the test output
+and a nice report in the `coverage` directory. I'd like to move to mutation based coverage testing,
+but that's a project for another day.
+
+The tests do output a few images to the `/tmp/` directory, which I'm pretty sure means it won't work
+on Windows. This is fixable if there is a need, so if that gets in your way just ask.
+
+`rake rubocop` checks code formatting, `rake rubocop:auto_correct` will try to fix any rubocop
+issues, if possible.
+
+`rake` will run all tests and rubocop.
+
+### Docker
+
+The following commands will build and run the tests inside a docker image.
+
+```bash
+$ docker build . -t jpt
+$ docker run -t jpt
+```

data/docs/devs/index.md

@@ -0,0 +1,7 @@
+---
+sort: 2
+---
+
+# Development
+
+{% include list.liquid %}

data/docs/{releases.md → devs/releases.md}

@@ -1,7 +1,27 @@
 ---
 ---
 # Release History
-
+* 1.13.0 November 23, 2020
+  * Add image quality interpolation; allows for variable image quality based on image size.
+  * Bugfix: Perform format, resize, and quality changes simultaneously rather than individually.
+    * Allows for actual lossless webp: simply set quality to 100.
+    * Improves fresh (no cached images) build times by ~15%
+    * Fix problems with poor image quality.
+* 1.12.0 July 30, 2020
+  * Documentation overhaul. Now with 87% less scrolling!
+  * Rename `markup_presets` and `media_presets` to `presets` and
+    `media_queries`. The old names were bad and caused confusion. The old names
+    will continue to work until the next major version is released.
+* 1.11.0 July 27, 2020
+  * **Width and height attribute support!** Begone, page reflow.
+  * Cache image information between builds
+  * Change image naming format. This update will trigger all images to be
+    regenerated, so you may want to delete your generated images folder
+    beforehand.
+* 1.10.2 July 6, 2020
+  * Bugfix for fallback image files not actually getting generated
+* 1.10.1 July 2, 2020
+  * Bugfix for erroneously regenerated images
 * 1.10.0 May 11, 2020
   * **Image Cropping support!** access the power of ImageMagick's `crop` function.
   * Don't issue a warning when `default` preset is not found.
@@ -9,23 +29,25 @@
 * 1.9.0 Feb 2, 2020
   * Add `fast_build` global setting
   * Add `disabled` global setting
-  * Reduce unnecessary disk IO; sites with many source images should see build times improve when
-    no new images need to be generated.
-  * Add support for empty attributes; specifically so best-practice for decorative images (`alt=""`)
-    is possible.
+  * Reduce unnecessary disk IO; sites with many source images should see build
+  times improve when no new images need to be generated.
+  * Add support for empty attributes; specifically so best-practice for
+    decorative images (`alt=""`) is possible.
 * 1.8.0 Nov 25, 2019
   * Add `data_sizes` setting for the `data_` family of output formats.
 * 1.7.1 Nov 14, 2019
   * Fix some HTML attribute related bugs
   * Add a few items to the FAQ
 * 1.7.0 Aug 12, 2019
-  * Add support for setting generated image quality, either generally or specific to given
-    formats.
+  * Add support for setting generated image quality, either generally or
+    specific to given formats.
   * Add support for spaces and other url-encoded characters in filenames
-  * Documentation restructure - Moved it out of the wiki, into the `docs` folder.
+  * Documentation restructure - Moved it out of the wiki, into the `docs`
+    folder.
   * Bugfix: Fallback image width will now be checked against source image width.
   * Bugfix: Minor fix to nomarkdown wrapper output
-  * link_source will now target the base source image, rather than finding the biggest one.
+  * link_source will now target the base source image, rather than finding the
+    biggest one.
   * Remove fastimage dependency, add addressable dependency.
   * Moderately significant refactoring and code cleanup 
   * Decent set of tests added
@@ -36,14 +58,15 @@
   * better `{::nomarkdown}` necessity detection
   * allow user to override `{::nomarkdown}` autodetection
 * 1.4.0 Jun 26, 2019:
-  * Rename gem from `jekyll-picture-tag` to `jekyll_picture_tag`, allowing us to use rubygems again.
+  * Rename gem from `jekyll-picture-tag` to `jekyll_picture_tag`, allowing us to
+    use rubygems again.
   * Add new output format: `naked_srcset`.
 * 1.3.1 Jun 21, 2019: Bugfix
 * 1.3.0 Jun  7, 2019:
   * Initial compatibility with Jekyll 4.0
   * bugfixes
-  * change to generated image naming-- The first build after this update will be longer, and you
-    might want to clear out your generated images.
+  * change to generated image naming-- The first build after this update will be
+    longer, and you might want to clear out your generated images.
 * 1.2.0 Feb  9, 2019:
   * Add nomarkdown fix
   * noscript option
@@ -54,7 +77,8 @@
   * auto-orient images before stripping metadata
 * 1.0.2 Jan 18, 2019: Fix ruby version specification
 * 1.0.1 Jan 13, 2019: Added ruby version checking
-* **1.0.0** Nov 27, 2018: Rewrite from the ground up. See the [migration guide]({{ site.baseurl }}/migration).
+* **1.0.0** Nov 27, 2018: Rewrite from the ground up. See the 
+* [migration guide]({{ site.baseurl }}/users/notes/migration).
 * 0.2.2 Aug  2, 2013: Bugfixes
 * 0.2.1 Jul 17, 2013: Refactor again, add Liquid parsing.
 * 0.2.0 Jul 14, 2013: Rewrite code base, bring in line with Jekyll Image Tag.