jekyll-vitepress-theme 1.7.0 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4843e410a1321baff08b82bd739e58ad72cdb1657445c37f3b2bc30aa59c57ef
-  data.tar.gz: c974fe75def3a63663a0e2c320798882af8b6878a2fc3261549187a384ce17a8
+  metadata.gz: 9e8e0506d69bd7172baf0392133cc0782815c07784a747437be2b7a59503ca37
+  data.tar.gz: 7037f54855dc45578def24ab7144a563f9211f7a441b110bfa56172cebdff91d
 SHA512:
-  metadata.gz: 146ac84e6b757422be14c5e206b4f0525e271f4bd45afdd70f47dad1388799765a6e6563d4ad45e88b7fb0dee3ebe7a4ea97d85220f62b760740d915383d2fcd
-  data.tar.gz: 2e99432a58ccbfaf1838acd5b7ddaf0d8e62a3b73e44b90fddcf8f369555bab65fa352c251c747eae46cd69dd14987bdda2366ab5ffebdb8faf44c7b1756c2dc
+  metadata.gz: '08cad3bf3e61558a9ca8a9832f1ad95943289691c6832961405551f62d43399294a3f709f1e120a5a265a664c39ee46b3591a2e39dd20e3dc3ad92b3c603ea46'
+  data.tar.gz: 2cedeabbc9f8be7ded0ed39164d7808bc63178e84a7ef06aa2da6bddcfd6262047490eff29eb36da1dcd80393c0aba1bc33cc4340a5358af02bc4373c02f568e

data/README.md

@@ -78,6 +78,14 @@ bundle install
 bundle exec jekyll serve --livereload
 ```
 
+### Metadata and jekyll-seo-tag
+
+The theme writes the page description, canonical link, Open Graph, and Twitter
+card tags itself. Calling `{% seo %}` as well emits a second copy of each, so
+drop it when you switch to this theme, or drop the theme's tags if you prefer
+jekyll-seo-tag's. Its JSON-LD has no equivalent here, so keep that plugin if
+you want structured data.
+
 ## Screenshots
 
 | Home | Docs |

data/_includes/doc_footer.html

@@ -56,7 +56,14 @@
 {% assign prev_doc = nil %}
 {% assign next_doc = nil %}
 {% if page.collection %}
-  {% assign docs = site[page.collection] | sort: 'nav_order' %}
+  {% assign generated_sidebar = site.data.jekyll_vitepress_sidebar %}
+  {% assign sidebar_collections = generated_sidebar.collections %}
+  {% assign sidebar_collection = sidebar_collections[page.collection] %}
+  {% if sidebar_collection and sidebar_collection.docs %}
+    {% assign docs = sidebar_collection.docs %}
+  {% else %}
+    {% assign docs = site[page.collection] | sort: 'nav_order' %}
+  {% endif %}
   {% assign found_current = false %}
   {% for doc in docs %}
     {% if found_current and next_doc == nil %}

data/_includes/nav.html

@@ -103,8 +103,20 @@
               {% if versions and versions.items and versions.items.size > 0 %}
                 <div class="VPVersionSelector" id="vp-version-selector">
                   <button type="button" class="button" id="vp-version-button" aria-haspopup="true" aria-expanded="false" aria-controls="vp-version-menu">
+                    {%- comment -%}
+                      `current` names an item, by id or title, the way
+                      version_link.html matches it. Show that item's title so a
+                      manifest holding ids does not label the button "next".
+                    {%- endcomment -%}
+                    {%- assign version_current_label = versions.current -%}
+                    {%- for version_item in versions.items -%}
+                      {%- assign version_item_key = version_item.id | default: version_item.title -%}
+                      {%- if version_item_key == versions.current or version_item.title == versions.current -%}
+                        {%- assign version_current_label = version_item.title -%}
+                      {%- endif -%}
+                    {%- endfor -%}
                     <span class="text">
-                      <span>{{ versions.current | default: 'Version' }}</span>
+                      <span>{{ version_current_label | default: 'Version' }}</span>
                       <span class="vpi-chevron-down text-icon"></span>
                     </span>
                   </button>

data/_includes/sidebar.html

@@ -3,42 +3,60 @@
   <nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1">
     <span class="visually-hidden" id="sidebar-aria-label">Sidebar Navigation</span>
 
-    {% assign sidebar_groups = site.data.sidebar %}
+    {% assign generated_sidebar = site.data.jekyll_vitepress_sidebar %}
+    {% assign sidebar_groups = generated_sidebar.groups | default: site.data.sidebar %}
     {% for group in sidebar_groups %}
-      {% assign docs = site[group.collection] | sort: 'nav_order' %}
-      {% if docs.size > 0 %}
+      {% if group.items %}
+        {% assign sidebar_items = group.items %}
+      {% else %}
+        {% assign docs = site[group.collection] | sort: 'nav_order' %}
+        {% assign sidebar_items = docs %}
+      {% endif %}
+      {% if sidebar_items.size > 0 %}
         {% assign has_active = false %}
-        {% for doc in docs %}
-          {% if doc.url == page.url %}
-            {% assign has_active = true %}
-          {% endif %}
-        {% endfor %}
+        {% if group.active_urls contains page.url %}
+          {% assign has_active = true %}
+        {% else %}
+          {% for doc in docs %}
+            {% if doc.url == page.url %}
+              {% assign has_active = true %}
+            {% endif %}
+          {% endfor %}
+        {% endif %}
+        {% assign collapsed = false %}
+        {% if group.collapsed and has_active == false %}
+          {% assign collapsed = true %}
+        {% endif %}
 
         <div class="group no-transition">
-          <section class="VPSidebarItem level-0 collapsible{% if has_active %} has-active{% endif %}" data-vp-sidebar-group data-collection="{{ group.collection }}">
-            <div class="item" role="button" tabindex="0">
+          <section class="VPSidebarItem level-0 collapsible{% if has_active %} has-active{% endif %}{% if collapsed %} collapsed{% endif %}" data-vp-sidebar-group data-collection="{{ group.collection }}">
+            <div class="item" role="button" tabindex="0" aria-expanded="{% if collapsed %}false{% else %}true{% endif %}">
               <div class="indicator"></div>
               <h2 class="text">{{ group.title }}</h2>
-              <div class="caret" role="button" aria-label="toggle section" tabindex="0">
+              <div class="caret" role="button" aria-label="toggle section" tabindex="0" aria-expanded="{% if collapsed %}false{% else %}true{% endif %}">
                 <span class="vpi-chevron-right caret-icon"></span>
               </div>
             </div>
 
             <div class="items">
-              {% for doc in docs %}
-                {% assign active = false %}
-                {% if doc.url == page.url %}
-                  {% assign active = true %}
-                {% endif %}
-                <div class="VPSidebarItem level-1 is-link{% if active %} is-active{% endif %}">
-                  <div class="item">
-                    <div class="indicator"></div>
-                    <a class="VPLink link link" href="{{ doc.url | relative_url }}" data-vp-sidebar-link data-turbo="true" data-turbo-frame="vp-content-frame" data-turbo-action="advance">
-                      <p class="text">{{ doc.title }}</p>
-                    </a>
+              {% if group.items %}
+                {% include sidebar_items.html nodes=group.items level=1 %}
+              {% else %}
+                {% for doc in docs %}
+                  {% assign active = false %}
+                  {% if doc.url == page.url %}
+                    {% assign active = true %}
+                  {% endif %}
+                  <div class="VPSidebarItem level-1 is-link{% if active %} is-active{% endif %}">
+                    <div class="item">
+                      <div class="indicator"></div>
+                      <a class="VPLink link link" href="{{ doc.url | relative_url }}" data-vp-sidebar-link data-turbo="true" data-turbo-frame="vp-content-frame" data-turbo-action="advance">
+                        <p class="text">{{ doc.title }}</p>
+                      </a>
+                    </div>
                   </div>
-                </div>
-              {% endfor %}
+                {% endfor %}
+              {% endif %}
             </div>
           </section>
         </div>

data/_includes/sidebar_items.html

@@ -0,0 +1,41 @@
+{% for node in include.nodes %}
+  {% assign item_level = include.level | default: 1 %}
+  {% assign doc = node.doc %}
+  {% assign has_children = false %}
+  {% if node.children and node.children.size > 0 %}
+    {% assign has_children = true %}
+  {% endif %}
+  {% assign active = false %}
+  {% if node.url == page.url %}
+    {% assign active = true %}
+  {% endif %}
+  {% assign has_active = false %}
+  {% if node.active_urls contains page.url %}
+    {% assign has_active = true %}
+  {% endif %}
+  {% assign collapsed = false %}
+  {% if node.collapsed and has_active == false %}
+    {% assign collapsed = true %}
+  {% endif %}
+
+  <div class="VPSidebarItem level-{{ item_level }} is-link{% if has_children %} collapsible{% endif %}{% if active %} is-active{% endif %}{% if has_active %} has-active{% endif %}{% if collapsed %} collapsed{% endif %}">
+    <div class="item"{% if has_children %} aria-expanded="{% if collapsed %}false{% else %}true{% endif %}"{% endif %}>
+      <div class="indicator"></div>
+      <a class="VPLink link link" href="{{ node.url | relative_url }}" data-vp-sidebar-link data-turbo="true" data-turbo-frame="vp-content-frame" data-turbo-action="advance">
+        <p class="text">{{ node.title | default: doc.title }}</p>
+      </a>
+      {% if has_children %}
+        <div class="caret" role="button" aria-label="toggle section" tabindex="0" aria-expanded="{% if collapsed %}false{% else %}true{% endif %}">
+          <span class="vpi-chevron-right caret-icon"></span>
+        </div>
+      {% endif %}
+    </div>
+
+    {% if has_children %}
+      <div class="items">
+        {% assign child_level = item_level | plus: 1 %}
+        {% include sidebar_items.html nodes=node.children level=child_level %}
+      </div>
+    {% endif %}
+  </div>
+{% endfor %}

data/assets/css/vitepress-overrides.css

@@ -329,6 +329,11 @@ body.vp-nav-screen-open .VPNav {
   width: 100%;
   height: 100%;
   fill: currentcolor;
+
+  /* These icons draw a 16-unit viewBox into a 13-14px box. Their paths touch
+     the viewBox edge, so at a fractional scale the SVG viewport clips the
+     outermost column and the shape looks flat on one side. */
+  overflow: visible;
 }
 
 .VPNavBarStarText,
@@ -1120,6 +1125,11 @@ body.vp-search-open {
   width: 100%;
   height: 100%;
   fill: currentcolor;
+
+  /* These icons draw a 16-unit viewBox into a 13-14px box. Their paths touch
+     the viewBox edge, so at a fractional scale the SVG viewport clips the
+     outermost column and the shape looks flat on one side. */
+  overflow: visible;
 }
 
 .VPMetricButtonCount {

data/assets/js/vitepress-theme.js

@@ -684,12 +684,28 @@
   syncNavTop();
   window.addEventListener('scroll', syncNavTop, { passive: true });
 
-  document.querySelectorAll('.VPSidebarItem.level-0.collapsible').forEach(function (section) {
+  function setSidebarSectionCollapsed(section, collapsed) {
+    section.classList.toggle('collapsed', collapsed);
+
+    var item = section.querySelector(':scope > .item');
+    var caret = section.querySelector(':scope > .item .caret');
+    var expanded = String(!collapsed);
+
+    if (item) {
+      item.setAttribute('aria-expanded', expanded);
+    }
+
+    if (caret) {
+      caret.setAttribute('aria-expanded', expanded);
+    }
+  }
+
+  document.querySelectorAll('.VPSidebarItem.collapsible').forEach(function (section) {
     var item = section.querySelector(':scope > .item');
     var caret = section.querySelector(':scope > .item .caret');
 
     function toggleSection() {
-      section.classList.toggle('collapsed');
+      setSidebarSectionCollapsed(section, !section.classList.contains('collapsed'));
     }
 
     if (item) {
@@ -701,6 +717,10 @@
       });
 
       item.addEventListener('keydown', function (event) {
+        if (event.target.closest('a')) {
+          return;
+        }
+
         if (event.key === 'Enter' || event.key === ' ') {
           event.preventDefault();
           toggleSection();
@@ -2174,7 +2194,7 @@
       return null;
     }
 
-    var activeItems = Array.from(sidebar.querySelectorAll('.VPSidebarItem.level-1.is-link.is-active'));
+    var activeItems = Array.from(sidebar.querySelectorAll('.VPSidebarItem.is-link.is-active'));
 
     if (!activeItems.length) {
       return null;
@@ -2212,16 +2232,19 @@
     }
 
     document.querySelectorAll('[data-vp-sidebar-link]').forEach(function (link) {
-      var item = link.closest('.VPSidebarItem.level-1.is-link');
+      var item = link.closest('.VPSidebarItem.is-link');
       var active = normalizePathname(link.getAttribute('href')) === currentPath;
       if (item) {
         item.classList.toggle('is-active', active);
       }
     });
 
-    document.querySelectorAll('[data-vp-sidebar-group]').forEach(function (group) {
-      var hasActiveLink = !!group.querySelector('.VPSidebarItem.level-1.is-link.is-active');
+    document.querySelectorAll('.VPSidebarItem.collapsible').forEach(function (group) {
+      var hasActiveLink = group.classList.contains('is-active') || !!group.querySelector('.VPSidebarItem.is-link.is-active');
       group.classList.toggle('has-active', hasActiveLink);
+      if (hasActiveLink) {
+        setSidebarSectionCollapsed(group, false);
+      }
     });
 
     document.querySelectorAll('[data-vp-nav-link]').forEach(function (link) {

data/lib/jekyll/vitepress_theme/hooks.rb

@@ -3,6 +3,248 @@ require 'rouge'
 
 module Jekyll
   module VitePressTheme
+    # rubocop:disable Metrics/ModuleLength
+    module Sidebar
+      module_function
+
+      DATA_KEY = 'jekyll_vitepress_sidebar'.freeze
+      MAX_ITEM_LEVEL = 5
+
+      def apply(site)
+        generated_sidebar = generate(site)
+        site.data[DATA_KEY] = generated_sidebar if generated_sidebar
+      rescue StandardError => e
+        Jekyll.logger.warn('jekyll-vitepress-theme', "Sidebar hierarchy generation failed: #{e.message}")
+      end
+
+      # A site with collection documents and no _data/sidebar.yml builds a page
+      # with an empty sidebar and no other complaint, which is a slow thing to
+      # notice. Overriding `data_dir` without carrying the file over is the
+      # usual cause.
+      def warn_missing_sidebar_data(site)
+        return if site.collections.values.all? { |collection| collection.docs.empty? }
+
+        Jekyll.logger.warn(
+          'jekyll-vitepress-theme',
+          'No _data/sidebar.yml found, so the sidebar will be empty. ' \
+          'If you set a custom data_dir, copy the theme data files into it.'
+        )
+      end
+
+      def generate(site)
+        sidebar_groups = site.data['sidebar']
+        unless sidebar_groups.respond_to?(:each)
+          warn_missing_sidebar_data(site)
+          return nil
+        end
+
+        groups = sidebar_groups.filter_map { |group| generated_group(site, group) }
+
+        {
+          'groups' => groups,
+          'collections' => groups.to_h { |group| [group['collection'], collection_data(group)] }
+        }
+      end
+
+      def generated_group(site, group)
+        collection_name = group_value(group, 'collection')
+        docs = collection_docs(site, collection_name)
+        return nil if docs.empty?
+
+        collection_data = build_collection(collection_name, docs)
+        return nil if collection_data['docs'].empty?
+
+        group_hash(group).merge(collection_data)
+      end
+
+      def collection_data(group)
+        group.slice('collection', 'items', 'docs', 'active_urls')
+      end
+
+      def build_collection(collection_name, docs)
+        ordered_docs = sort_docs(docs)
+        nodes = ordered_docs.to_h { |doc| [doc, node_for(doc)] }
+        roots = attach_nodes(collection_name, ordered_docs, nodes)
+
+        finalize_nodes(roots, 1)
+        flat_docs = flatten_docs(roots)
+        {
+          'collection' => collection_name.to_s,
+          'items' => roots,
+          'docs' => flat_docs,
+          'active_urls' => flat_docs.filter_map { |doc| doc_url(doc) }
+        }
+      end
+
+      def attach_nodes(collection_name, docs, nodes)
+        docs.each_with_object([]) do |doc, roots|
+          parent_doc = parent_doc_for(doc, docs)
+          if valid_parent?(doc, parent_doc, docs)
+            nodes[parent_doc]['children'] << nodes[doc]
+          else
+            warn_missing_parent(collection_name, doc) if parent_title(doc)
+            roots << nodes[doc]
+          end
+        end
+      end
+
+      def valid_parent?(doc, parent_doc, docs)
+        parent_doc && !attaching_creates_cycle?(doc, parent_doc, docs)
+      end
+
+      def collection_docs(site, collection_name)
+        return [] unless collection_name
+
+        collection = site.collections[collection_name.to_s]
+        return [] unless collection
+
+        collection.docs
+      end
+
+      def group_hash(group)
+        return group if group.is_a?(Hash)
+
+        group.respond_to?(:to_h) ? group.to_h : {}
+      end
+
+      def group_value(group, key)
+        group_hash(group)[key] || group_hash(group)[key.to_sym]
+      end
+
+      def sort_docs(docs)
+        docs.sort_by { |doc| sort_key(doc) }
+      end
+
+      def sort_key(doc)
+        nav_order = data_value(doc, 'nav_order')
+        order_bucket = nav_order.nil? ? 1 : 0
+        numeric_order = numeric?(nav_order)
+        order_type = numeric_order ? 0 : 1
+        order_value = numeric_order ? nav_order.to_f : nav_order.to_s
+
+        [order_bucket, order_type, order_value, title(doc).downcase, doc_url(doc).to_s]
+      end
+
+      def numeric?(value)
+        value.is_a?(Numeric) || value.to_s.match?(/\A-?\d+(?:\.\d+)?\z/)
+      end
+
+      def node_for(doc)
+        {
+          'doc' => doc,
+          'title' => title(doc),
+          'url' => doc_url(doc),
+          'collapsed' => truthy?(data_value(doc, 'collapsed')),
+          'children' => [],
+          'active_urls' => []
+        }
+      end
+
+      def parent_doc_for(doc, docs)
+        direct_parent = parent_title(doc)
+        return nil unless direct_parent
+
+        candidates = docs.select { |candidate| candidate != doc && title(candidate) == direct_parent }
+        grand_parent = normalized_string(data_value(doc, 'grand_parent'))
+        return candidates.first unless grand_parent
+
+        candidates.find { |candidate| ancestor_titles(candidate, docs).include?(grand_parent) }
+      end
+
+      def attaching_creates_cycle?(doc, parent_doc, docs)
+        current = parent_doc
+        seen = []
+
+        while current
+          return true if current == doc || seen.include?(current)
+
+          seen << current
+          current = parent_doc_for(current, docs)
+        end
+
+        false
+      end
+
+      def ancestor_titles(doc, docs)
+        titles = []
+        current = parent_doc_for(doc, docs)
+        seen = []
+
+        while current && !seen.include?(current)
+          seen << current
+          titles << title(current)
+          current = parent_doc_for(current, docs)
+        end
+
+        titles
+      end
+
+      def finalize_nodes(nodes, level)
+        nodes.sort_by! { |node| sort_key(node['doc']) }
+        nodes.each do |node|
+          finalize_children(node, level)
+
+          node['active_urls'] = [node['url'], *node['children'].flat_map { |child| child['active_urls'] }].compact
+        end
+      end
+
+      def finalize_children(node, level)
+        if level >= MAX_ITEM_LEVEL
+          warn_depth_limit(node) unless node['children'].empty?
+          node['children'] = []
+        else
+          finalize_nodes(node['children'], level + 1)
+        end
+      end
+
+      def flatten_docs(nodes)
+        nodes.flat_map do |node|
+          [node['doc'], *flatten_docs(node['children'])]
+        end
+      end
+
+      def data_value(doc, key)
+        data = doc.respond_to?(:data) ? doc.data : {}
+        data[key] || data[key.to_sym]
+      end
+
+      def title(doc)
+        normalized_string(data_value(doc, 'title')) || ''
+      end
+
+      def parent_title(doc)
+        normalized_string(data_value(doc, 'parent'))
+      end
+
+      def doc_url(doc)
+        doc.url if doc.respond_to?(:url)
+      end
+
+      def normalized_string(value)
+        string = value.to_s.strip
+        string.empty? ? nil : string
+      end
+
+      def truthy?(value)
+        value == true || value.to_s.casecmp('true').zero?
+      end
+
+      def warn_missing_parent(collection_name, doc)
+        Jekyll.logger.warn(
+          'jekyll-vitepress-theme',
+          "Missing sidebar parent '#{parent_title(doc)}' for '#{title(doc)}' in #{collection_name}; rendering it at the collection root."
+        )
+      end
+
+      def warn_depth_limit(node)
+        Jekyll.logger.warn(
+          'jekyll-vitepress-theme',
+          "Sidebar item '#{node['title']}' is deeper than #{MAX_ITEM_LEVEL} item levels; nested children were not rendered."
+        )
+      end
+    end
+    # rubocop:enable Metrics/ModuleLength
+
     module SearchIndex
       module_function
 
@@ -19,9 +261,14 @@ module Jekyll
           }
           {% assign first = false %}
         {% endif %}
-        {% assign sidebar_groups = site.data.sidebar %}
+        {% assign generated_sidebar = site.data.jekyll_vitepress_sidebar %}
+        {% assign sidebar_groups = generated_sidebar.groups | default: site.data.sidebar %}
         {% for group in sidebar_groups %}
-          {% assign docs = site[group.collection] | sort: 'nav_order' %}
+          {% if group.docs %}
+            {% assign docs = group.docs %}
+          {% else %}
+            {% assign docs = site[group.collection] | sort: 'nav_order' %}
+          {% endif %}
           {% for doc in docs %}
             {% if doc.title and doc.url %}
               {% unless first %},{% endunless %}
@@ -154,7 +401,18 @@ module Jekyll
       module_function
 
       AUTO_VALUE = 'auto'.freeze
-
+      VERSION_PATTERN = /VERSION\s*=\s*['"]([^'"]+)['"]/
+
+      # Resolves `current: auto` to the version of the project being documented.
+      # Configure where to read it from:
+      #
+      #   jekyll_vitepress:
+      #     version:
+      #       value: "2.0.0"              # literal, wins over file
+      #       file: lib/my_gem/version.rb # or a file holding VERSION = '...'
+      #
+      # With neither, it falls back to this theme's own version, which is only
+      # ever right for the theme's own documentation.
       def apply(site)
         versions = site.data['versions']
         return unless versions.is_a?(Hash)
@@ -162,11 +420,35 @@ module Jekyll
         current_value = versions['current'] || versions[:current]
         return unless auto_value?(current_value)
 
-        versions['current'] = "v#{Jekyll::VitePressTheme::VERSION}"
+        versions['current'] = "v#{site_version(site) || Jekyll::VitePressTheme::VERSION}"
       rescue StandardError => e
         Jekyll.logger.warn('jekyll-vitepress-theme', "Version label resolution failed: #{e.message}")
       end
 
+      def site_version(site)
+        config = site.config.dig('jekyll_vitepress', 'version')
+        return nil unless config.is_a?(Hash)
+
+        literal = config['value'].to_s.strip
+        return normalize(literal) unless literal.empty?
+
+        version_from_file(site, config['file'])
+      end
+
+      def version_from_file(site, path)
+        return nil if path.to_s.strip.empty?
+
+        full_path = File.expand_path(path.to_s, site.source)
+        return nil unless File.file?(full_path)
+
+        match = File.read(full_path)[VERSION_PATTERN]
+        match && normalize(Regexp.last_match(1))
+      end
+
+      def normalize(value)
+        value.to_s.strip.sub(/\Av/, '')
+      end
+
       def auto_value?(value)
         value.to_s.strip.casecmp(AUTO_VALUE).zero?
       end
@@ -236,6 +518,7 @@ end
 Jekyll::Hooks.register :site, :post_read do |site|
   Jekyll::VitePressTheme::VersionLabel.apply(site)
   Jekyll::VitePressTheme::RougeStyles.apply(site)
+  Jekyll::VitePressTheme::Sidebar.apply(site)
   Jekyll::VitePressTheme::SearchIndex.apply(site)
 end
 

data/lib/jekyll/vitepress_theme/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
   module VitePressTheme
-    VERSION = "1.7.0".freeze
+    VERSION = "1.8.1".freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-vitepress-theme
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.1
 platform: ruby
 authors:
 - Carmine Paolino
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-16 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -79,6 +79,7 @@ files:
 - _includes/rubygems_downloads_button.html
 - _includes/search.html
 - _includes/sidebar.html
+- _includes/sidebar_items.html
 - _includes/version_link.html
 - _includes/vp_image.html
 - _layouts/default.html