jekyll_all_collections 0.3.7 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef8537c4507dd09e37bf5309509a95df04f8c9927c95aea7a3a936c93aa09e7c
-  data.tar.gz: 32fc6fa905a809fa63b500828092bc99e0e6fe8c2fe2728ac90fe341d579d72a
+  metadata.gz: e43e220bfaba4972fb8a1bb90a54818dbc14a30e9433937a2ef97aa33f5ef049
+  data.tar.gz: 150e4651e714ca0e3d70bdb088032c7e27e1f3d31c7c5610312cd9f118574907
 SHA512:
-  metadata.gz: 8b943b685144dc0d406d8322c48d2f4e8f9a4bceeea8264df2ec0d2dc02eb4903e0fc5e619025fa9c924a2216117f26288f22837a236ba9162b4286a05ce5092
-  data.tar.gz: 0a2428d792af7fd3088b696fcdb5fc7e9936fdbd166eda15b7a11e407de9b32f2ac9f35e6bd9b58406767fbed20d6bf98d8803b708b9e5752f19878440d1b2d5
+  metadata.gz: 7553236876b6a247d8550bcd7772416956aee5b6b0a87a4042e8083395f177e4c3a8ee0cb93a0e927a1b17be487baac0ffdfeb7c94c0ea2a85f9a8a5825b99ea
+  data.tar.gz: 72f1fb5193dd8251f06b5393440d1bf68d8f185a55f310af52e426c00ac82890a4023115b8c92d8a5391c686729b5532b1e7d8d728536aa1991d9c153eabe8c8

data/.rubocop.yml

@@ -9,6 +9,7 @@ AllCops:
   Exclude:
     - binstub/**/*
     - demo/_site/*
+    - demo/binstub/*
     - vendor/**/*
     - Gemfile*
   NewCops: enable
@@ -29,6 +30,9 @@ Layout/HashAlignment:
 Layout/LineLength:
   Max: 150
 
+Lint/MissingCopEnableDirective:
+  Enabled: false
+
 Metrics/AbcSize:
   Max: 55
 
@@ -37,6 +41,9 @@ Metrics/BlockLength:
     - jekyll_plugin_support.gemspec
   Max: 30
 
+Metrics/ClassLength:
+  Enabled: false
+
 Metrics/CyclomaticComplexity:
   Max: 25
 
@@ -54,6 +61,9 @@ Naming/FileName:
 RSpec/ExampleLength:
   Max: 30
 
+RSpec/IndexedLet:
+  Enabled: false
+
 RSpec/SpecFilePathFormat:
   Enabled: false
   IgnoreMethods: true
@@ -61,7 +71,7 @@ RSpec/SpecFilePathFormat:
 RSpec/SpecFilePathSuffix:
   Enabled: false
 
-RSpec/IndexedLet:
+RSpec/MultipleDescribes:
   Enabled: false
 
 RSpec/MultipleExpectations:
@@ -70,12 +80,20 @@ RSpec/MultipleExpectations:
 Style/ClassVars:
   Enabled: false
 
+Style/CommentedKeyword:
+  Enabled: false
+
 Style/Documentation:
   Enabled: false
 
 Style/FrozenStringLiteralComment:
   Enabled: false
 
+Style/GlobalVars:
+  Exclude:
+    - "**/*_spec.rb"
+    - "*_spec.rb"
+
 Style/StringConcatenation:
   Enabled: false
 

data/CHANGELOG.md

@@ -1,13 +1,34 @@
 # Changelog
 
+## 0.4.0 / 2025-02-07
+
+* **This plugin is deprecated.**
+  The functionality will be folded into <code>jekyll_plugin_support</code>.
+  The last release of this plugin will halt Jekyll and tell you to remove it from the Jekyll website <code>Gemfile</code>
+  and to use <code>jekyll_plugin_support</code> instead.
+* Added `AllCollectionsHooks.all_documents`, `AllCollectionsHooks.everything`,
+  `AllCollectionsHooks.site`, and `AllCollectionsHooks.sorted_lru_files` properties,
+  accessible from every other module.
+* Added `site.all_documents`, `site.everything`, and `sorted_lru_files` properties.
+
+  * `all_collections` includes all documents in all collections.
+
+  * `all_documents` includes `all_collections` plus all standalone pages.
+
+  * `everything` includes `all_documents` plus all static files.
+
+  * `sorted_lru_files` is used by a new binary search lookup for matching page suffixes.
+    Currently only `jekyll_href` and `jekyll_draft` use this feature.
+
+
 ## 0.3.7 / 2024-12-21
 
-* `AllCollectionsTag.class.evaluate` made compatible with Ruby 3.2.2
+* `AllCollectionsTag.class.evaluate` made compatible with Ruby 3.2.2.
 
 
 ## 0.3.6 / 2024-07-23
 
-* Made compatible with module renaming in JekyllPluginSupport v1.0.0
+* Made compatible with module renaming in JekyllPluginSupport v1.0.0.
 
 
 ## 0.3.5 / 2024-03-26
@@ -19,7 +40,7 @@
 
 ## 0.3.4 / 2023-12-24
 
-* Changed dependency to Jekyll >= 4.3.2
+* Changed dependency to Jekyll >= 4.3.2.
 
 
 ## 0.3.3 / 2023-05-22
@@ -30,25 +51,25 @@
 
 ## 0.3.2 / 2023-04-05
 
-* Modified dependency `'jekyll_plugin_support', '>= 0.5.0'`
+* Modified dependency `'jekyll_plugin_support', '>= 0.5.0'`.
 
 
 ## 0.3.1 / 2023-03-16
 
-* Reduced the verbosity of the `@logger` message
+* Reduced the verbosity of the `@logger` message.
 
 ## 0.3.0 / 2023-02-16
 
-* Updated dependency `'jekyll_plugin_support', '~> 0.5.0'`
+* Updated dependency `'jekyll_plugin_support', '~> 0.5.0'`.
 
 ## 0.2.2 / 2023-02-12
 
-* Updated dependency `'jekyll_plugin_support', '~> 0.4.0'`
+* Updated dependency `'jekyll_plugin_support', '~> 0.4.0'`.
 
 
 ## 0.2.1 / 2023-02-12
 
-* Reduced the verbosity of log output from `info` to `debug`
+* Reduced the verbosity of log output from `info` to `debug`.
 
 
 ## 0.2.0 / 2023-02-04
@@ -65,4 +86,4 @@
 
 ## 0.1.0 / 2022-04-26
 
-* Initial version published
+* Initial version published.

data/README.md

@@ -1,35 +1,156 @@
 # `jekyll_all_collections` [![Gem Version](https://badge.fury.io/rb/jekyll_all_collections.svg)](https://badge.fury.io/rb/jekyll_all_collections)
 
 
-`Jekyll_all_collections` is a Jekyll plugin that adds a new property called `all_collections` to `site`.
-It also provides a new Jekyll tag called `all_collections`,
-which creates a formatted listing of all posts and documents from all collections,
-sorted by age, newest to oldest.
+`Jekyll_all_collections` is a Jekyll plugin that includes a generator,
+triggered by a high-priority hook, and a block tag called `all_collections`.
 
-The collection consists of an array of objects with the following properties:
-`content` (HTML or Markdown), `data` (array), `date` (Ruby Date), `description`, `destination`,
-`draft` (Boolean), `excerpt` (HTML or Markdown), `ext`, `label`, `last_modified` or `last_modified_at` (Ruby Date),
-`layout`, `path`, `relative_path`, `tags`, `title`, `type`, and `url`.
 
-Pages that are not in any collection are not included.
+## Generator
 
+The generator adds four new attributes to
+[`site`](https://jekyllrb.com/docs/variables/#site-variables):
+`all_collections`, `all_documents`, `everything`, and `sorted_lru_files`.
 
-## Installation
+These three attributes can be referenced as `site.everything`, `site.all_collections`
+and `site.all_documents`.
+
+* `all_collections` includes all documents in all collections.
+
+* `all_documents` includes `all_collections` plus all standalone pages.
+
+* `everything` includes `all_documents` plus all static files.
+
+* `sorted_lru_files` is used by a new binary search lookup for matching page suffixes.
+  Currently only `jekyll_href` and `jekyll_draft` use this feature.
+
+
+### Collection Management
+
+Jekyll provides inconsistent attributes for
+[`site.pages`](https://jekyllrb.com/docs/pages/),
+[`site.posts`](https://jekyllrb.com/docs/posts/) and
+[`site.static_files`](https://jekyllrb.com/docs/static-files/).
+
+
+* While the `url` attributes of items in `site.posts` and `site.pages` start with a slash (/),
+  `site.static_files` items do not have a `url` attribute.
+* Static files have a `relative_path` attribute, which starts with a slash (/),
+  but although that attribute is also provided in `site.posts` and `site.pages`,
+  those values do not start with a slash.
+* Paths ending with a slash (`/`) imply that a file called `index.html` should be fetched.
+* HTML redirect files created by the
+  [`jekyll-redirect-from`](https://github.com/jekyll/jekyll-redirect-from) Jekyll plugin,
+  which are included in `site.static_files`, should be ignored.
 
-Add this line to your application's Gemfile:
+These inconsistencies mean that combining the standard three collections of files
+provided as `site` attributes will create a new collection that is difficult
+to process consistently:
 
 ```ruby
-group :jekyll_plugins do
-  gem 'jekyll_all_collections'
-end
+# This pseudocode creates `oops`, which is problematic to process consistently
+oops = site.all_collections + site.pages + site.static_files
 ```
 
-And then execute:
+`oops`, above, is difficult to process because of inconsistencies in the provided attributes
+and how the attributes are constructed.
 
-```shell
-$ bundle
+
+### Solving The Problem
+
+The generator normalizes these inconsistencies by utilizing the `APage` class
+and filtering out HTML redirect files.
+
+The `all_collections` collection contains `APage` representations of `site.collections`.
+
+The `all_documents` collection contains `APage` representations of `site.pages`.
+
+The `everything` collection contains `APage` representations of:
+
+```text
+# Pseudocode
+site.collections + site.pages + site.static_files - HTML_redirect_files
+```
+
+
+## The APage Class
+
+The `site.all_collections`, `site.all_documents` and `site.everything` attributes
+consist of arrays of [`APage`](lib/hooks/a_page.rb) instances.
+
+The `APage` class has the following attributes:
+`content` (HTML or Markdown), `data` (array), `date` (Ruby Date), `description`, `destination`,
+`draft` (Boolean), `ext`, `href`, `label`, `last_modified` or `last_modified_at` (Ruby Date),
+`layout`, `origin`, `path`, `relative_path`, `tags`, `title`, `type`, and `url`.
+
+* `href` always starts with a slash.
+  This value is consistent with `a href` values in website HTML.
+  Paths ending with a slash (`/`) have `index.html` appended so the path specifies an actual file.
+
+* `origin` indicates the original source of the item.
+  Possible values are `collection`, `individual_page` and `static_file`.
+  Knowing the origin of each item allows code to process each type of item appropriately.
+
+
+## Block Tag
+
+The `all_collections` block tag creates a formatted listing of Jekyll files.
+The ordering is configurable; by default, the listing is sorted by `date`, newest to oldest.
+The `all_collections` tag has a `data_source` parameter that specifies which new property to report on
+(`all_collections`, `all_documents`, or `everything`).
+
+
+## Installation
+
+### Installing In A Jekyll Website
+
+1. Add the CSS found in
+   [`demo/assets/css/jekyll_all_collections.css`](demo/assets/css/jekyll_all_collections.css)
+   to your Jekyll layout(s).
+
+2. Add the following to your Jekyll website's `Gemfile`, within the `jekyll_plugins` group:
+
+   ```ruby
+   group :jekyll_plugins do
+     gem 'jekyll_all_collections', '>= 0.3.8'
+     gem 'jekyll_draft', '>=2.1.0'
+   end
+   ```
+
+3. Type:
+
+   ```shell
+   $ bundle
+   ```
+
+
+### Installing As a Gem Dependency
+
+1. Add the following to your gem’s `.gemspec`:
+
+   ```ruby
+   spec.add_dependency 'jekyll_all_collections', '>= 0.3.8'
+   spec.add_dependency 'jekyll_draft', '>=2.1.0'
+   ```
+
+2. Type:
+
+   ```shell
+   $ bundle
+   ```
+
+
+## Demo
+
+The [`demo`](./demo) directory contains a demonstration website, which uses the plugin.
+To run, type:
+
+```console
+$ bin/setup
+$ demo/_bin/debug -r
 ```
 
+Now point your web browser to http://localhost:4444
+
 
 ## Requirements
 
@@ -66,69 +187,51 @@ the `date` value will be used last modified date value.
 
 ## Usage
 
-### `Site.all_collections`
+### New `Site` Attributes
 
 No explicit initialization or setup is required.
-Jekyll plugins can access the value of `site.all_collections`, however Liquid code in Jekyll pages and documents cannot.
+Jekyll plugins can access the value of
+`site.all_collections`, `site.all_documents` and `site.everything`;
+however, Liquid code in Jekyll pages and documents cannot.
 
 
-### Plugin Usage
+### Excluding Files
 
-Jekyll generators and tags receive an enhanced version of the `site` Jekyll variable.
-A new array of `APage` instance called `all_collections` is added, one for each Jekyll document and page.
-Examine [`APage.rb`](https://github.com/mslinn/jekyll_all_collections/blob/v0.3.4/lib/all_collections_hooks.rb#L68-L102)
-to see the available properties.
-One particularly useful property is `url`, which is difficult to obtain from Jekyll.
+There are two ways to exclude files from the new `site` attributes.
 
-All `Jekyll::Page`s and `Jekyll:Document`s can be processed with the following sample code:
+1) The [`exclude` entry in `_config.yml`](https://jekyllrb.com/docs/configuration/options#global-configuration)
+   can be used as it normally would.
 
-```ruby
-(@site.all_collections + @site.pages).each do |page_or_apage|
-  do_something_with page_or_apage
-end
-```
-
-
-### `All_collections` Tag
+2) Adding the following entry to a page’s front matter causes that page to be excluded
+  from the collection created by this plugin:
 
-Add the following CSS to your stylesheet:
+   ```html
+   ---
+   exclude_from_all: true
+   ---
+   ```
 
-```css
-.posts {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: space-between;
-  line-height: 170%;
-}
 
-.posts > *:nth-child(odd) {
-  width: 120px;
-  font-family: Monaco,"Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
-  font-stretch: semi-condensed;
-  font-size: 10pt;
-}
+### Plugin Usage
 
-.posts > *:nth-child(even) {
-  width: calc(100% - 120px);
-}
-```
+Jekyll generators and tags receive an enhanced version of the `site` Jekyll variable.
 
 
-#### Excluding Pages
+#### From a Custom Plugin
 
-Adding the following entry to a page’s front matter causes that page to be excluded
-from the collection created by this plugin:
+In the following example of how to use the `all_collections` plugin in a custom plugin,
+the `do_something_with` function processes all `Jekyll::Page`s, `Jekyll:Document`s, and static files.
 
-```html
----
-exclude_from_all: true
----
+```ruby
+@site.everything.each do |apage|
+  do_something_with apage
+end
 ```
 
 
-#### General Form
+#### Using the Block Tag
 
-The general form of the Jekyll tag is:
+The general form of the Jekyll tag, including all options, is:
 
 ```html
 {% all_collections
@@ -140,7 +243,7 @@ The general form of the Jekyll tag is:
 ```
 
 
-#### `date_column` Attribute
+##### `date_column` Attribute
 
 One of two date columns can be displayed in the generated HTML:
 either `date` (when the article was originally written),
@@ -148,7 +251,7 @@ or `last_modified`.
 The default value for the `date_column` attribute is `date`.
 
 
-#### `heading` Attribute
+##### `heading` Attribute
 
 If no `heading` attribute is specified, a heading will automatically be generated, which contains the `sort_by` values,
 for example:
@@ -157,7 +260,7 @@ for example:
 {% all_collections id='abcdef' sort_by="last_modified" %}
 ```
 
-Generates a heading like:
+The above generates a heading like:
 
 ```html
 <h2 id="abcdef">All Posts Sorted By last_modified</h2>
@@ -171,11 +274,12 @@ specify an empty string for the value of `heading`:
 ```
 
 
-#### `id` Attribute
+##### `id` Attribute
 
 If your Jekyll layout employs [`jekyll-toc`](https://github.com/allejo/jekyll-toc), then `id` attributes are important.
 The `jekyll-toc` include checks for `id` attributes in `h2` ... `h6` tags, and if found,
-and if the attribute value is enclosed in double quotes (`id="my_id"`, not `id='my_id'`),
+and if the attribute value is enclosed in double quotes
+(`id="my_id"`, not single quotes like `id='my_id'`),
 then the heading is included in the table of contents.
 
 To suppress an `id` from being generated,
@@ -187,13 +291,13 @@ specify an empty string for the value of `id`, like this:
 ```
 
 
-#### `SORT_KEYS` Values
+##### `SORT_KEYS` Values
 
 `SORT_KEYS` specifies how to sort the collection.
 Values can include one or more of the following attributes:
 `date`, `destination`, `draft`, `label`, `last_modified`, `last_modified_at`, `path`, `relative_path`,
 `title`, `type`, and `url`.
-Ascending sorts are the default, however a descending sort can be achieved by prepending `-` before an attribute.
+Ascending sorts are the default; however, a descending sort can be achieved by prepending `-` before an attribute.
 
 To specify more than one sort key, provide a comma-delimited string of values.
 Included spaces are ignored.
@@ -228,7 +332,9 @@ title: Testing, 1, 2, 3
 {% all_collections %}
 ```
 
-Explicitly express the default sort
+Following are examples of how to specify the sort parameters.
+
+**Explicitly express the default sort**<br>
 (sort by the date originally written, newest to oldest):
 
 ```html
@@ -241,19 +347,20 @@ Sort by date, from oldest to newest:
 {% all_collections sort_by="date" %}
 ```
 
-Sort by the date last modified, oldest to newest:
+**Sort by the date last modified, oldest to newest:**
 
 ```html
 {% all_collections sort_by="last_modified" %}
 ```
 
-Sort by the date last modified, newest to oldest:
+**Sort by the date last modified, newest to oldest:**
 
 ```html
 {% all_collections sort_by="-last_modified" %}
 ```
 
-Several attributes can be specified as sort criteria by passing them as a comma-delimited string.
+**Several attributes can be specified as sort criteria**<br>
+by passing them as a comma-delimited string.
 Included spaces are ignored:
 
 ```html
@@ -262,7 +369,7 @@ Included spaces are ignored:
 {% all_collections sort_by="-last_modified, -date, title" %}
 ```
 
-The following two examples produce the same output:
+**The following two examples produce the same output:**
 
 ```html
 {% all_collections sort_by="-last_modified,-date" %}
@@ -270,18 +377,6 @@ The following two examples produce the same output:
 ```
 
 
-## Demo
-
-The [`demo`](./demo) directory contains a demonstration website, which uses the plugin.
-To run, type:
-
-```console
-$ demo/_bin/debug -r
-```
-
-Now point your web browser to http://localhost:4444
-
-
 ## Debugging
 
 You can control the verbosity of log output by adding the following to `_config.yml` in your Jekyll project:
@@ -291,10 +386,13 @@ plugin_loggers:
   AllCollectionsTag::AllCollectionsTag: warn
 ```
 
+1. First set breakpoints in the Ruby code that interests you.
 
-1. You have two options for initiating a debug session:
+2. You have several options for initiating a debug session:
 
-   1. Run `demo/_bin/debug`, without the `-r` options shown above.
+   1. Use the **Debug Demo** Visual Studio Code launch configuration.
+
+   2. Type the `demo/_bin/debug` command, without the `-r` options shown above.
 
       ```console
       ... lots of output as bundle update runs...
@@ -311,7 +409,7 @@ plugin_loggers:
       Fast Debugger (ruby-debug-ide 0.7.3, debase 0.2.5.beta2, file filtering is supported) listens on 0.0.0.0:1234
       ```
 
-   2. Run `bin/attach` and pass the directory name of a Jekyll website that has a suitable script called `_bin/debug`.
+   3. Run `bin/attach` and pass the directory name of a Jekyll website that has a suitable script called `_bin/debug`.
       The `demo` subdirectory fits this description.
 
       ```console
@@ -322,18 +420,21 @@ plugin_loggers:
       Fast Debugger (ruby-debug-ide 0.7.3, debase 0.2.4.1, file filtering is supported) listens on 0.0.0.0:1234
       ```
 
-2. Set breakpoints in Ruby code.
 
-3. Attach to the debugger process.
-  This git repo includes a [Visual Studio Code launcher](./.vscode/launch.json) for this purpose labeled `Listen for rdebug-ide`.
+3. Attach to the debugger process if required.
+  This git repo includes two [Visual Studio Code launch configurations](./.vscode/launch.json) for this purpose labeled
+  **Attach rdbg** and **Attach with ruby_lsp**.
 
 4. Point your web browser to http://localhost:4444
 
+If a debugging session terminates abruptly and leaves ports tied up,
+run the `demo/_bin/release_port` script.
+
 
 ## Additional Information
 
 More information is available on Mike Slinn's website about
-[Jekyll plugins](https://www.mslinn.com/blog/index.html#Jekyll).
+[Jekyll plugins](https://mslinn.com/jekyll_plugins/jekyll_all_collections.html).
 
 
 ## Development
@@ -349,8 +450,8 @@ To build and install this gem onto your local machine, run:
 
 ```shell
 $ bundle exec rake install
-jekyll_all_collections 0.1.0 built to pkg/jekyll_all_collections-0.1.0.gem.
-jekyll_all_collections (0.1.0) installed.
+jekyll_all_collections 0.3.8 built to pkg/jekyll_all_collections-0.3.8.gem.
+jekyll_all_collections (0.3.8) installed.
 ```
 
 Examine the newly built gem:
@@ -360,23 +461,25 @@ $ gem info jekyll_all_collections
 
 *** LOCAL GEMS ***
 
-jekyll_all_collections (0.1.0)
+jekyll_all_collections (0.3.8)
     Author: Mike Slinn
-    Homepage: https://www.mslinn.com/blog/2020/12/30/jekyll-plugin-template-collection.html
+    Homepage:
+    https://www.mslinn.com/jekyll_plugins/jekyll_all_collections.html
     License: MIT
-    Installed at: /home/mslinn/.rbenv/versions/3.1.0/lib/ruby/gems/3.1.0
+    Installed at (0.3.8): /home/mslinn/.rbenv/versions/3.2.2/lib/ruby/gems/3.2.0
 
-    Provides a collection of all collections in site.all_collections.
+    Provides normalized collections and extra functionality for Jekyll websites.
 ```
 
 
 ### Build and Push to RubyGems
 
-To release a new version,
+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:
+2. Add an entry in `CHANGELOG.md` describing the changes since the last release.
+3. Commit all changes to git; if you don't the next step might fail with a confusing error message.
+4. Run the following:
 
     ```shell
     $ bundle exec rake release
@@ -388,10 +491,10 @@ To release a new version,
 
 ## Contributing
 
-1. Fork the project
-2. Create a descriptively named feature branch
-3. Add your feature
-4. Submit a pull request
+1. Fork the project.
+2. Create a descriptively named feature branch.
+3. Add your feature.
+4. Submit a pull request.
 
 
 ## License

data/jekyll_all_collections.gemspec

@@ -4,16 +4,11 @@ Gem::Specification.new do |spec|
   github = 'https://github.com/mslinn/jekyll_all_collections'
 
   spec.authors     = ['Mike Slinn']
-  spec.bindir      = 'exe'
   spec.description = <<~END_OF_DESC
-    Provides a collection of all collections in site.all_collections.
+    Provides normalized collections and extra functionality for Jekyll websites.
   END_OF_DESC
-  spec.email       = ['mslinn@mslinn.com']
-  spec.executables = []
-
-  # Specify which files should be added to the gem when it is released.
-  spec.files = Dir['.rubocop.yml', 'LICENSE.*', 'Rakefile', '{lib,spec}/**/*', '*.gemspec', '*.md']
-
+  spec.email    = ['mslinn@mslinn.com']
+  spec.files    = Dir['.rubocop.yml', 'LICENSE.*', 'Rakefile', '{lib,spec}/**/*', '*.gemspec', '*.md']
   spec.homepage = 'https://www.mslinn.com/jekyll_plugins/jekyll_all_collections.html'
   spec.license  = 'MIT'
   spec.metadata = {
@@ -27,10 +22,11 @@ Gem::Specification.new do |spec|
   spec.platform              = Gem::Platform::RUBY
   spec.require_paths         = ['lib']
   spec.required_ruby_version = '>= 2.6.0'
-  spec.summary               = 'Provides a collection of all collections in site.all_collections.'
+  spec.summary               = 'Provides normalized collections and extra functionality for Jekyll websites.'
   spec.version               = JekyllAllCollectionsVersion::VERSION
 
   spec.add_dependency 'jekyll', '>= 3.5.0'
   spec.add_dependency 'jekyll_draft'
   spec.add_dependency 'jekyll_plugin_support'
+  spec.add_dependency 'sorted_set'
 end