jekyll-vitepress-theme 1.8.1 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e8e0506d69bd7172baf0392133cc0782815c07784a747437be2b7a59503ca37
-  data.tar.gz: 7037f54855dc45578def24ab7144a563f9211f7a441b110bfa56172cebdff91d
+  metadata.gz: d3f4205e18a7cb5f642be4e0a827a024f488030143e11a11816123ba53792757
+  data.tar.gz: 53e6432abfd64ab03aef151445484a1c5852f13ed55880f1481d9a541ed1bf83
 SHA512:
-  metadata.gz: '08cad3bf3e61558a9ca8a9832f1ad95943289691c6832961405551f62d43399294a3f709f1e120a5a265a664c39ee46b3591a2e39dd20e3dc3ad92b3c603ea46'
-  data.tar.gz: 2cedeabbc9f8be7ded0ed39164d7808bc63178e84a7ef06aa2da6bddcfd6262047490eff29eb36da1dcd80393c0aba1bc33cc4340a5358af02bc4373c02f568e
+  metadata.gz: 14be8fc302967f0f9e625bb666adf40ab0af14e6f338981ede4e639d9acd47d9e3172248bf4ddc50be57bb17a51fae9b9c049f4b02bf07f5d631a1310ba974a8
+  data.tar.gz: 7c51764e8ae51818ec881a2b25b82babd90c10f21153763171852b7925451ca08a5601e49c0497f0a8060f614c6710c731c3dee30245b01676e59150eb3bc770

data/README.md

@@ -26,6 +26,7 @@ The unusual part is navigation. Jekyll VitePress uses Turbo Frames like a Rails
 - **[VitePress polish for Jekyll](https://jekyll-vitepress.dev/vitepress-parity/):** match VitePress for the docs homepage, sidebar, outline, search, dark mode, callouts, code blocks, and doc footers.
 - **Jekyll-native setup:** keep your Markdown, Liquid, YAML, and static hosting. Add the gem, set a few options, and publish.
 - **Fast docs navigation:** Turbo Frames update the content area while the nav, sidebar, and shell stay mounted.
+- **Search and AI discovery by default:** ship canonical metadata, social cards, JSON-LD, nested breadcrumbs, sitemap, robots controls, `llms.txt`, and `llms-full.txt` without another discovery plugin.
 - **[More than VitePress](https://jekyll-vitepress.dev/extensions-to-vitepress/):** add GitHub Star and Sponsor buttons, RubyGems downloads, versions, labels, generated local search, and Copy Page/View as Markdown for LLM workflows.
 - **Static Ruby output:** build with Jekyll and deploy the generated HTML to GitHub Pages, any CDN, or any static host.
 
@@ -78,13 +79,15 @@ bundle install
 bundle exec jekyll serve --livereload
 ```
 
-### Metadata and jekyll-seo-tag
+### SEO is built in
 
-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.
+Every site using the theme gets one consistent set of search and social metadata, JSON-LD (`WebSite`, `WebPage` or `Article`, `Organization`/`Person`, image, and nested breadcrumbs), `sitemap.xml`, and `robots.txt`. Canonical overrides, `noindex`, language alternates, social images, authors, publishers, and webmaster verification tokens are configurable without another plugin.
+
+Set at least `title`, `description`, and an absolute production `url` in `_config.yml`. The build warns about missing and duplicate metadata. Do not also render `{% seo %}` or enable another sitemap/robots generator; that creates duplicated or contradictory signals.
+
+### LLM discovery is built in
+
+The theme also creates `/llms.txt`, a concise canonical documentation index, and `/llms-full.txt`, a single Markdown bundle containing every eligible page and collection document. Redirects, `404` pages, `noindex` pages, and external-canonical duplicates are excluded. Both files understand `baseurl` and can be configured or disabled without `jekyll-ai-visible-content`.
 
 ## Screenshots
 

data/_includes/copy_page_button.html

@@ -18,7 +18,7 @@
         <span class="copy-md-dropdown-desc">Copy page as Markdown for LLMs</span>
       </div>
     </button>
-    <a class="copy-md-dropdown-item" href="{{ view_md_url | relative_url }}" target="_blank" rel="noreferrer">
+    <a class="copy-md-dropdown-item" href="{{ view_md_url | relative_url }}" target="_blank" rel="nofollow noreferrer">
       <span class="vpi-file-text copy-md-dropdown-icon"></span>
       <div class="copy-md-dropdown-text">
         <span class="copy-md-dropdown-title">View as Markdown</span>

data/_includes/head.html

@@ -1,37 +1,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  {% assign page_title = page.title | default: site.title %}
-  {% capture full_title %}{% if page_title and page_title != site.title %}{{ page_title }} | {{ site.title }}{% else %}{{ site.title }}{% endif %}{% endcapture %}
-  {% assign full_title = full_title | strip %}
-  {% assign page_description = page.description | default: site.description %}
-  {% assign canonical_url = page.canonical_url | default: page.url | absolute_url %}
-  {% assign page_image = page.image %}
-  {% assign seo_image = site.logo | default: '/assets/images/favicon/web-app-manifest-512x512.png' %}
-  {% if page_image %}
-    {% if page_image.src %}
-      {% assign seo_image = page_image.src %}
-    {% elsif page_image.path %}
-      {% assign seo_image = page_image.path %}
-    {% else %}
-      {% assign seo_image = page_image %}
-    {% endif %}
-  {% endif %}
-  {% assign seo_image_url = seo_image | absolute_url %}
-  <title>{{ full_title }}</title>
-  <meta name="description" content="{{ page_description | escape }}">
-  <meta name="robots" content="index,follow,max-image-preview:large">
-  <link rel="canonical" href="{{ canonical_url }}">
-  <meta property="og:site_name" content="{{ site.title | escape }}">
-  <meta property="og:title" content="{{ full_title | escape }}">
-  <meta property="og:description" content="{{ page_description | escape }}">
-  <meta property="og:url" content="{{ canonical_url }}">
-  <meta property="og:type" content="{% if page.url == '/' %}website{% else %}article{% endif %}">
-  <meta property="og:image" content="{{ seo_image_url }}">
-  <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="{{ full_title | escape }}">
-  <meta name="twitter:description" content="{{ page_description | escape }}">
-  <meta name="twitter:image" content="{{ seo_image_url }}">
+  {% include seo.html %}
 
   {% assign theme = site.jekyll_vitepress %}
   {% assign branding = theme.branding %}

data/_includes/seo.html

@@ -0,0 +1,78 @@
+{% assign seo_config = site.jekyll_vitepress.seo %}
+{% assign seo_enabled = true %}
+{% if seo_config == false or seo_config.enabled == false or page.seo == false %}
+  {% assign seo_enabled = false %}
+{% endif %}
+
+{% if seo_enabled %}
+  {% assign seo = page._seo %}
+  {% if seo %}
+    <title>{{ seo.title | escape }}</title>
+    {% if seo.description %}<meta name="description" content="{{ seo.description | escape }}">{% endif %}
+    {% if seo.author.name %}<meta name="author" content="{{ seo.author.name | escape }}">{% endif %}
+    {% if seo.robots %}<meta name="robots" content="{{ seo.robots | escape }}">{% endif %}
+    {% if seo.canonical_url %}<link rel="canonical" href="{{ seo.canonical_url | escape }}">{% endif %}
+    {% if seo.sitemap_url %}<link rel="sitemap" type="application/xml" href="{{ seo.sitemap_url | escape }}">{% endif %}
+
+    <meta property="og:site_name" content="{{ site.title | default: site.jekyll_vitepress.branding.site_title | escape }}">
+    <meta property="og:title" content="{{ seo.page_title | escape }}">
+    {% if seo.description %}<meta property="og:description" content="{{ seo.description | escape }}">{% endif %}
+    {% if seo.canonical_url %}<meta property="og:url" content="{{ seo.canonical_url | escape }}">{% endif %}
+    <meta property="og:type" content="{{ seo.og_type }}">
+    <meta property="og:locale" content="{{ seo.locale | escape }}">
+    {% for alternate in seo.alternates %}
+      <meta property="og:locale:alternate" content="{{ alternate.locale | escape }}">
+      <link rel="alternate" hreflang="{{ alternate.hreflang | escape }}" href="{{ alternate.url | escape }}">
+    {% endfor %}
+    {% if seo.image.url %}
+      <meta property="og:image" content="{{ seo.image.url | escape }}">
+      {% if seo.image.url contains 'https://' %}<meta property="og:image:secure_url" content="{{ seo.image.url | escape }}">{% endif %}
+      {% if seo.image.alt %}<meta property="og:image:alt" content="{{ seo.image.alt | escape }}">{% endif %}
+      {% if seo.image.width %}<meta property="og:image:width" content="{{ seo.image.width }}">{% endif %}
+      {% if seo.image.height %}<meta property="og:image:height" content="{{ seo.image.height }}">{% endif %}
+    {% endif %}
+    {% if seo.og_type == 'article' %}
+      {% if seo.date_published %}<meta property="article:published_time" content="{{ seo.date_published }}">{% endif %}
+      {% if seo.date_modified %}<meta property="article:modified_time" content="{{ seo.date_modified }}">{% endif %}
+      {% if seo.author.url %}<meta property="article:author" content="{{ seo.author.url | escape }}">{% endif %}
+      {% if seo.facebook.publisher %}<meta property="article:publisher" content="{{ seo.facebook.publisher | escape }}">{% endif %}
+    {% endif %}
+    {% if seo.facebook.app_id %}<meta property="fb:app_id" content="{{ seo.facebook.app_id | escape }}">{% endif %}
+    {% if seo.facebook.admins %}<meta property="fb:admins" content="{{ seo.facebook.admins | escape }}">{% endif %}
+
+    <meta name="twitter:card" content="{{ seo.twitter.card | escape }}">
+    <meta name="twitter:title" content="{{ seo.page_title | escape }}">
+    {% if seo.description %}<meta name="twitter:description" content="{{ seo.description | escape }}">{% endif %}
+    {% if seo.image.url %}<meta name="twitter:image" content="{{ seo.image.url | escape }}">{% endif %}
+    {% if seo.image.alt %}<meta name="twitter:image:alt" content="{{ seo.image.alt | escape }}">{% endif %}
+    {% if seo.twitter.site %}<meta name="twitter:site" content="{{ seo.twitter.site | escape }}">{% endif %}
+    {% if seo.twitter.creator %}<meta name="twitter:creator" content="{{ seo.twitter.creator | escape }}">{% endif %}
+
+    {% for verification in seo.verifications %}
+      <meta name="{{ verification.name }}" content="{{ verification.content | escape }}">
+    {% endfor %}
+    {% if seo.json_ld %}<script type="application/ld+json">{{ seo.json_ld }}</script>{% endif %}
+  {% else %}
+    {% assign page_title = page.title | default: site.title | default: site.jekyll_vitepress.branding.site_title %}
+    {% capture full_title %}{% if page_title and page_title != site.title %}{{ page_title }} | {{ site.title }}{% else %}{{ site.title }}{% endif %}{% endcapture %}
+    {% assign page_description = page.description | default: site.description %}
+    {% assign canonical_url = page.canonical_url | default: page.url | absolute_url %}
+    {% assign page_image = page.image | default: site.logo %}
+    {% if page_image.src %}{% assign page_image = page_image.src %}{% endif %}
+    {% if page_image.path %}{% assign page_image = page_image.path %}{% endif %}
+    <title>{{ full_title | strip | escape }}</title>
+    {% if page_description %}<meta name="description" content="{{ page_description | strip_html | strip | escape }}">{% endif %}
+    <meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1">
+    {% if site.url %}<link rel="canonical" href="{{ canonical_url }}">{% endif %}
+    <meta property="og:site_name" content="{{ site.title | escape }}">
+    <meta property="og:title" content="{{ page_title | escape }}">
+    {% if page_description %}<meta property="og:description" content="{{ page_description | strip_html | strip | escape }}">{% endif %}
+    {% if site.url %}<meta property="og:url" content="{{ canonical_url }}">{% endif %}
+    <meta property="og:type" content="website">
+    {% if page_image %}<meta property="og:image" content="{{ page_image | absolute_url }}">{% endif %}
+    <meta name="twitter:card" content="{% if page_image %}summary_large_image{% else %}summary{% endif %}">
+    <meta name="twitter:title" content="{{ page_title | escape }}">
+    {% if page_description %}<meta name="twitter:description" content="{{ page_description | strip_html | strip | escape }}">{% endif %}
+    {% if page_image %}<meta name="twitter:image" content="{{ page_image | absolute_url }}">{% endif %}
+  {% endif %}
+{% endif %}

data/_layouts/default.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="{{ site.lang | default: 'en-US' }}">
+<html lang="{{ page._seo.language | default: page.lang | default: page.locale | default: site.lang | default: site.locale | default: 'en-US' }}"{% if page.dir or site.dir %} dir="{{ page.dir | default: site.dir }}"{% endif %}>
   {% include head.html %}
   {% assign theme = site.jekyll_vitepress %}
   {% assign behavior = theme.behavior %}
@@ -32,10 +32,12 @@
 
         <div class="VPContent{% if has_sidebar %} has-sidebar{% endif %}{% if is_home %} is-home{% endif %}" id="VPContent">
           {% if has_sidebar %}
-            {% assign frame_page_title = site.title %}
-            {% if page.title and page.title != site.title %}
-              {% capture frame_page_title %}{{ page.title }} | {{ site.title }}{% endcapture %}
-            {% endif %}
+            {% assign frame_page_title = page._seo.title | default: site.title %}
+            {% unless page._seo.title %}
+              {% if page.title and page.title != site.title %}
+                {% capture frame_page_title %}{{ page.title }} | {{ site.title }}{% endcapture %}
+              {% endif %}
+            {% endunless %}
             <turbo-frame id="vp-content-frame" target="_top">
               <div id="vp-page-state" hidden data-title="{{ frame_page_title | strip | escape }}" data-url="{{ page.url | relative_url }}" data-collection="{{ page.collection | default: '' | escape }}"></div>
               <div class="VPDoc has-sidebar has-aside">

data/lib/jekyll/vitepress_theme/hooks.rb

@@ -520,18 +520,28 @@ Jekyll::Hooks.register :site, :post_read do |site|
   Jekyll::VitePressTheme::RougeStyles.apply(site)
   Jekyll::VitePressTheme::Sidebar.apply(site)
   Jekyll::VitePressTheme::SearchIndex.apply(site)
+  Jekyll::VitePressTheme::SEO.apply(site)
+  Jekyll::VitePressTheme::LLMS.apply(site)
 end
 
 capture_page_state = lambda do |item, payload|
   if Jekyll::VitePressTheme::CopyPage.enabled?(item)
     raw = Jekyll::VitePressTheme::CopyPage.resolved_markdown(item, payload)
     item.data['_raw_markdown'] = Jekyll::VitePressTheme::CopyPage.with_title(raw, item.data['title'])
+    payload['page']['_raw_markdown'] = item.data['_raw_markdown'] if payload['page'].is_a?(Hash)
   end
 
-  next if item.data.key?('last_updated_at')
+  unless item.data.key?('last_updated_at')
+    updated_at = Jekyll::VitePressTheme::LastUpdated.source_file_time(item.site, item.path)
+    item.data['last_updated_at'] = updated_at if updated_at
+  end
+  payload['page']['last_updated_at'] = item.data['last_updated_at'] if payload['page'].is_a?(Hash)
 
-  updated_at = Jekyll::VitePressTheme::LastUpdated.source_file_time(item.site, item.path)
-  item.data['last_updated_at'] = updated_at if updated_at
+  Jekyll::VitePressTheme::SEO.prepare(item)
+  if payload['page'].is_a?(Hash)
+    payload['page']['_seo'] = item.data['_seo']
+    payload['page']['_seo_disabled'] = item.data['_seo_disabled']
+  end
 end
 
 Jekyll::Hooks.register :documents, :pre_render, &capture_page_state

data/lib/jekyll/vitepress_theme/llms.rb

@@ -0,0 +1,236 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module VitePressTheme
+    # Generates the proposed llms.txt index and its full-text companion from
+    # the same canonical, indexable content used by the theme's SEO layer.
+    # rubocop:disable Metrics/AbcSize, Metrics/ModuleLength
+    module LLMS
+      module_function
+
+      class GeneratedPage < Jekyll::PageWithoutAFile
+        def initialize(site, name, content)
+          super(site, site.source, '', name)
+          self.content = content
+          data['layout'] = nil
+          data['permalink'] = "/#{name}"
+          data['seo'] = false
+          data['sitemap'] = false
+          data['llms'] = false
+        end
+
+        def render_with_liquid?
+          false
+        end
+      end
+
+      def apply(site)
+        config = config_for(site)
+        return unless enabled?(config)
+
+        groups = content_groups(site)
+        return if groups.empty?
+
+        unless SEO.custom_output?(site, 'llms.txt')
+          site.pages << GeneratedPage.new(site, 'llms.txt', render_index(site, config, groups))
+        end
+
+        return unless full_text?(config) && !SEO.custom_output?(site, 'llms-full.txt')
+
+        site.pages << GeneratedPage.new(site, 'llms-full.txt', render_full(site, config, groups))
+      rescue StandardError => e
+        Jekyll.logger.warn('jekyll-vitepress-theme', "LLM discovery generation failed: #{e.message}")
+      end
+
+      def config_for(site)
+        theme_config = site.config['jekyll_vitepress']
+        return {} unless theme_config.is_a?(Hash)
+
+        value = theme_config.fetch('llms', {})
+        value == false ? false : hash_value(value)
+      end
+
+      def enabled?(config)
+        config != false && config.fetch('enabled', true) != false
+      end
+
+      def full_text?(config)
+        config.fetch('full', config.fetch('include_full_text', true)) != false
+      end
+
+      def content_groups(site)
+        eligible = SEO.html_items(site).select { |item| eligible?(item) }
+        used = {}.compare_by_identity
+        groups = []
+
+        home = eligible.find { |item| item.url == '/' }
+        add_group(groups, used, 'Overview', [home].compact)
+
+        sidebar_groups(site).each do |group|
+          docs = Array(group['docs']).select { |item| eligible.include?(item) }
+          add_group(groups, used, group['title'] || collection_title(group['collection']), docs)
+        end
+
+        remaining = eligible.reject { |item| used[item] }
+        remaining.group_by { |item| collection_label(item) }.each do |label, items|
+          title = label ? collection_title(label) : 'Pages'
+          add_group(groups, used, title, sorted_items(items))
+        end
+
+        groups
+      end
+
+      def eligible?(item)
+        return false if item.data['llms'] == false || item.data['redirect_to']
+        return false if ['/404.html', '/404/'].include?(item.url)
+
+        metadata = item.data['_seo']
+        robots = metadata&.dig('robots') || item.data['robots']
+        tokens = robots.to_s.downcase.split(/[\s,]+/)
+        return false if item.data['noindex'] == true || tokens.intersect?(%w[noindex none])
+
+        canonical = metadata&.dig('canonical_url')
+        self_url = SEO.absolute_url(item.site, item.url)
+        canonical.to_s.empty? || self_url.to_s.empty? || canonical == self_url
+      end
+
+      def render_index(site, config, groups)
+        lines = header_lines(site, config)
+        details = config['details'].to_s.strip
+        lines.push(details, '') unless details.empty?
+
+        if full_text?(config)
+          lines << '## Full Documentation'
+          lines << ''
+          lines << "- [Complete documentation](#{site_url(site, '/llms-full.txt')}): All canonical pages in one Markdown document."
+          lines << ''
+        end
+
+        groups.each do |group|
+          lines << "## #{plain_heading(group[:title])}"
+          lines << ''
+          group[:items].each do |item|
+            title = link_label(item_title(item))
+            entry = "- [#{title}](#{canonical_url(item)})"
+            description = item_description(item)
+            entry += ": #{description}" if description
+            lines << entry
+          end
+          lines << ''
+        end
+
+        "#{lines.join("\n").rstrip}\n"
+      end
+
+      def render_full(site, config, groups)
+        title = config['title'] || SEO.site_title(site) || 'Documentation'
+        description = config['description'] || site.config['description']
+        lines = ["# #{plain_heading(title)} — Full Documentation", '']
+        lines.push("> #{SEO.clean_text(description)}", '') if SEO.clean_text(description)
+
+        groups.flat_map { |group| group[:items] }.each do |item|
+          lines << '---'
+          lines << ''
+          lines << "# #{plain_heading(item_title(item))}"
+          lines << ''
+          lines << "Canonical URL: #{canonical_url(item)}"
+          lines << ''
+          content = strip_leading_title(raw_markdown(item, site))
+          content = item_description(item).to_s if content.empty?
+          lines << content
+          lines << ''
+        end
+
+        "#{lines.join("\n").rstrip}\n"
+      end
+
+      def header_lines(site, config)
+        title = config['title'] || SEO.site_title(site) || 'Documentation'
+        description = config['description'] || site.config['description']
+        lines = ["# #{plain_heading(title)}", '']
+        lines.push("> #{SEO.clean_text(description)}", '') if SEO.clean_text(description)
+        lines
+      end
+
+      def raw_markdown(item, site)
+        payload = site.site_payload.merge('page' => item.to_liquid)
+        raw = CopyPage.resolved_markdown(item, payload)
+        CopyPage.with_title(raw, item_title(item)).to_s.strip
+      end
+
+      def strip_leading_title(markdown)
+        markdown.to_s
+                .sub(/\A\s*#\s+[^\n]+\n+/, '')
+                .sub(%r{\A\s*<h1(?:\s[^>]*)?>.*?</h1>\s*}mi, '')
+                .sub(/\A\s*[^\n]+\n=+\s*\n+/, '')
+                .gsub(/\n{3,}/, "\n\n")
+                .strip
+      end
+
+      def canonical_url(item)
+        item.data.dig('_seo', 'canonical_url') || site_url(item.site, item.url)
+      end
+
+      def site_url(site, path)
+        SEO.absolute_url(site, path) || relative_url(site, path)
+      end
+
+      def relative_url(site, path)
+        baseurl = site.config['baseurl'].to_s.sub(%r{/+\z}, '')
+        path = "/#{path}" unless path.start_with?('/')
+        "#{baseurl}#{path}"
+      end
+
+      def item_title(item)
+        item.data.dig('_seo', 'page_title') || SEO.clean_text(item.data['title']) || item.url
+      end
+
+      def item_description(item)
+        SEO.clean_text(item.data.dig('_seo', 'description') || item.data['description'])
+      end
+
+      def sidebar_groups(site)
+        data = site.data['jekyll_vitepress_sidebar']
+        data.is_a?(Hash) ? Array(data['groups']) : []
+      end
+
+      def add_group(groups, used, title, items)
+        items = items.reject { |item| used[item] }
+        return if items.empty?
+
+        items.each { |item| used[item] = true }
+        groups << { title: title, items: items }
+      end
+
+      def sorted_items(items)
+        items.sort_by do |item|
+          order = item.data['nav_order']
+          [order.is_a?(Numeric) ? order : Float::INFINITY, item.url.to_s]
+        end
+      end
+
+      def collection_label(item)
+        return unless item.respond_to?(:collection) && item.collection
+
+        item.collection.label
+      end
+
+      def collection_title(label)
+        label.to_s.tr('_-', ' ').split.map(&:capitalize).join(' ')
+      end
+
+      def plain_heading(value)
+        SEO.clean_text(value).to_s.gsub(/[\r\n#]+/, ' ').strip
+      end
+
+      def link_label(value)
+        plain_heading(value).gsub(/([\[\]])/, '\\\1')
+      end
+
+      def hash_value(value)
+        value.is_a?(Hash) ? value : {}
+      end
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/ModuleLength
+  end
+end

data/lib/jekyll/vitepress_theme/seo.rb

@@ -0,0 +1,593 @@
+# frozen_string_literal: true
+
+require 'cgi'
+require 'json'
+require 'time'
+require 'uri'
+
+module Jekyll
+  module VitePressTheme
+    # Generates the metadata shared by the HTML head, sitemap, and robots.txt.
+    # Keeping those outputs on one canonical URL resolver prevents contradictory
+    # indexing signals across theme consumers.
+    # rubocop:disable Metrics/AbcSize, Metrics/ModuleLength
+    module SEO
+      module_function
+
+      DEFAULT_ROBOTS = 'index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1'
+      ARTICLE_TYPES = %w[Article BlogPosting NewsArticle TechArticle].freeze
+      VERIFICATION_NAMES = {
+        'google' => 'google-site-verification',
+        'bing' => 'msvalidate.01',
+        'yandex' => 'yandex-verification',
+        'baidu' => 'baidu-site-verification',
+        'facebook' => 'facebook-domain-verification'
+      }.freeze
+
+      class GeneratedPage < Jekyll::PageWithoutAFile
+        def initialize(site, name, content)
+          super(site, site.source, '', name)
+          self.content = content
+          data['layout'] = nil
+          data['sitemap'] = false
+          data['seo'] = false
+        end
+      end
+
+      def apply(site)
+        return unless enabled?(site)
+
+        items = html_items(site)
+        items.each { |item| prepare(item) }
+        warn_about_metadata(site, items)
+        generate_discovery_files(site, items)
+      rescue StandardError => e
+        Jekyll.logger.warn('jekyll-vitepress-theme', "SEO generation failed: #{e.message}")
+      end
+
+      def prepare(item)
+        return unless enabled?(item.site)
+
+        page_config = page_config(item)
+        if page_config == false
+          item.data['_seo_disabled'] = true
+          item.data.delete('_seo')
+          return
+        end
+
+        metadata = metadata_for(item, page_config)
+        item.data['_seo'] = metadata
+        item.data['sitemap'] = false unless sitemap_candidate?(item, metadata)
+        metadata
+      end
+
+      def enabled?(site)
+        config = config_for(site)
+        config != false && !(config.is_a?(Hash) && config['enabled'] == false)
+      end
+
+      def config_for(site)
+        theme_config = site.config['jekyll_vitepress']
+        return {} unless theme_config.is_a?(Hash)
+
+        value = theme_config.fetch('seo', {})
+        value == false ? false : hash_value(value)
+      end
+
+      def page_config(item)
+        value = item.data['seo']
+        return false if value == false
+
+        value.is_a?(Hash) ? value : {}
+      end
+
+      def metadata_for(item, page_config = page_config(item))
+        site = item.site
+        config = config_for(site)
+        page_title = clean_text(page_config['title'] || item.data['title'] || site_title(site))
+        full_title = full_title_for(page_title, site_title(site), config)
+        description = clean_text(page_config['description'] || item.data['description'] || site.config['description'])
+        canonical = canonical_url(site, page_config['canonical_url'] || item.data['canonical_url'] || item.url)
+        locale = locale_for(item)
+        image = image_for(item, page_config, config)
+        author = author_for(item, page_config)
+        schema_type = schema_type_for(item, page_config, config)
+        dates = dates_for(item, page_config)
+        robots = robots_for(item, page_config, config)
+        alternates = alternates_for(item, page_config)
+        publisher = publisher_for(site, config)
+
+        metadata = {
+          'title' => full_title,
+          'page_title' => page_title,
+          'description' => description,
+          'canonical_url' => canonical,
+          'locale' => locale.tr('-', '_'),
+          'language' => locale.tr('_', '-'),
+          'robots' => robots,
+          'og_type' => ARTICLE_TYPES.include?(schema_type) ? 'article' : 'website',
+          'image' => image,
+          'author' => author,
+          'twitter' => twitter_for(item, author),
+          'facebook' => hash_value(site.config['facebook']),
+          'verifications' => verifications_for(site),
+          'alternates' => alternates,
+          'date_published' => dates['published'],
+          'date_modified' => dates['modified'],
+          'sitemap_url' => sitemap_enabled?(config) ? absolute_url(site, '/sitemap.xml') : nil
+        }
+        metadata['json_ld'] = json_ld_for(item, metadata, schema_type, publisher, config)
+        metadata
+      end
+
+      def full_title_for(page_title, title, config)
+        return title if page_title.to_s.empty?
+        return page_title if title.to_s.empty? || page_title == title
+
+        template = config.is_a?(Hash) ? config['title_template'] : nil
+        if template.to_s.include?(':page') || template.to_s.include?(':site')
+          clean_text(template.to_s.gsub(':page', page_title).gsub(':site', title))
+        else
+          separator = config.is_a?(Hash) ? config.fetch('title_separator', ' | ') : ' | '
+          "#{page_title}#{separator}#{title}"
+        end
+      end
+
+      def robots_for(item, page_config, config)
+        explicit = page_config['robots'] || item.data['robots']
+        return clean_text(explicit) if explicit && explicit != true
+
+        site_index = !config.is_a?(Hash) || config.fetch('index', true) != false
+        noindex = page_config['noindex'] == true || item.data['noindex'] == true || !site_index
+        nofollow = page_config['nofollow'] == true || item.data['nofollow'] == true
+        return "noindex,#{nofollow ? 'nofollow' : 'follow'}" if noindex
+
+        return DEFAULT_ROBOTS unless config.is_a?(Hash)
+
+        clean_text(config['robots']) || DEFAULT_ROBOTS
+      end
+
+      def image_for(item, page_config, config)
+        raw = page_config['image'] || item.data['image']
+        raw ||= config['image'] if config.is_a?(Hash)
+        raw ||= item.site.config['logo']
+        return nil if raw.nil? || raw == false
+
+        image = raw.is_a?(Hash) ? raw : { 'path' => raw }
+        path = image['path'] || image['src'] || image['url']
+        return nil if path.to_s.strip.empty?
+
+        {
+          'url' => absolute_url(item.site, path),
+          'alt' => clean_text(image['alt'] || item.data['image_alt'] || item.data['title'] || site_title(item.site)),
+          'width' => positive_integer(image['width']),
+          'height' => positive_integer(image['height'])
+        }.compact
+      end
+
+      def author_for(item, page_config)
+        value = page_config['author'] || item.data['author'] || item.site.config['author']
+        return nil if value.nil? || value == false
+
+        author = value.is_a?(Hash) ? value : { 'name' => value }
+        name = clean_text(author['name'] || author[:name])
+        return nil if name.to_s.empty?
+
+        {
+          'name' => name,
+          'url' => absolute_url(item.site, author['url'] || author[:url]),
+          'twitter' => clean_text(author['twitter'] || author[:twitter])
+        }.compact
+      end
+
+      def publisher_for(site, config)
+        raw = config['publisher'] if config.is_a?(Hash)
+        return nil unless raw.is_a?(Hash)
+
+        name = clean_text(raw['name'] || site_title(site))
+        return nil if name.to_s.empty?
+
+        type = %w[Organization Person].include?(raw['type']) ? raw['type'] : 'Organization'
+        image = raw['logo'] || site.config['logo']
+        same_as = Array(raw['same_as'] || raw['sameAs']).filter_map do |url|
+          absolute_url(site, url)
+        end
+
+        {
+          'type' => type,
+          'name' => name,
+          'url' => absolute_url(site, raw['url'] || '/'),
+          'logo' => absolute_url(site, image.is_a?(Hash) ? image['path'] || image['src'] : image),
+          'same_as' => same_as
+        }.compact
+      end
+
+      def twitter_for(item, author = nil)
+        site_twitter = hash_value(item.site.config['twitter'])
+        page_twitter = hash_value(item.data['twitter'])
+        creator = page_twitter['creator'] || page_twitter['username'] || author&.dig('twitter')
+
+        {
+          'card' => page_twitter['card'] || site_twitter['card'] || 'summary_large_image',
+          'site' => twitter_handle(site_twitter['username']),
+          'creator' => twitter_handle(creator)
+        }.compact
+      end
+
+      def verifications_for(site)
+        values = hash_value(site.config['webmaster_verifications'])
+        values['google'] ||= site.config['google_site_verification']
+
+        VERIFICATION_NAMES.filter_map do |key, name|
+          content = clean_text(values[key])
+          { 'name' => name, 'content' => content } if content
+        end
+      end
+
+      def alternates_for(item, page_config)
+        raw = page_config['alternates'] || item.data['alternates']
+        Array(raw).filter_map do |alternate|
+          next unless alternate.is_a?(Hash)
+
+          language = clean_text(alternate['lang'] || alternate['hreflang'])
+          url = absolute_url(item.site, alternate['url'] || alternate['href'])
+          next if language.to_s.empty? || url.to_s.empty?
+
+          { 'hreflang' => language, 'url' => url, 'locale' => language.tr('-', '_') }
+        end
+      end
+
+      def dates_for(item, page_config)
+        page_theme = hash_value(item.data['jekyll_vitepress'])
+        published = page_config['date_published'] || item.data['date_published']
+        published ||= item.data['date'] if posts_document?(item)
+        modified = page_config['date_modified'] || item.data['date_modified'] || item.data['last_modified_at']
+        modified ||= page_theme['last_updated_at']
+
+        {
+          'published' => xml_time(published),
+          'modified' => xml_time(modified)
+        }.compact
+      end
+
+      def schema_type_for(item, page_config, config)
+        value = page_config['type']
+        value ||= config['page_type'] if config.is_a?(Hash)
+        value = 'WebPage' if value.to_s.empty? || item.url == '/'
+        clean_text(value)
+      end
+
+      def json_ld_for(item, metadata, schema_type, publisher, config)
+        return nil if config.is_a?(Hash) && config.dig('schema', 'enabled') == false
+        return nil if metadata['canonical_url'].to_s.empty?
+
+        site = item.site
+        root_url = absolute_url(site, '/')
+        website_id = "#{root_url}#website"
+        webpage_id = "#{metadata['canonical_url']}#webpage"
+        graph = []
+
+        if publisher
+          publisher_id = "#{root_url}#identity"
+          identity = {
+            '@type' => publisher['type'], '@id' => publisher_id,
+            'name' => publisher['name'], 'url' => publisher['url']
+          }
+          identity['logo'] = { '@type' => 'ImageObject', 'url' => publisher['logo'] } if publisher['logo']
+          identity['sameAs'] = publisher['same_as'] unless publisher['same_as'].empty?
+          graph << identity
+        end
+
+        website = {
+          '@type' => 'WebSite', '@id' => website_id, 'url' => root_url,
+          'name' => site_title(site), 'description' => clean_text(site.config['description']),
+          'inLanguage' => metadata['language']
+        }.compact
+        website['publisher'] = { '@id' => "#{root_url}#identity" } if publisher
+        graph << website
+
+        if metadata['image']
+          graph << {
+            '@type' => 'ImageObject', '@id' => "#{metadata['image']['url']}#primaryimage",
+            'url' => metadata['image']['url'], 'contentUrl' => metadata['image']['url'],
+            'caption' => metadata['image']['alt'], 'width' => metadata['image']['width'],
+            'height' => metadata['image']['height']
+          }.compact
+        end
+
+        article_type = ARTICLE_TYPES.include?(schema_type)
+        webpage = {
+          '@type' => article_type ? 'WebPage' : schema_type,
+          '@id' => webpage_id, 'url' => metadata['canonical_url'],
+          'name' => metadata['page_title'],
+          'description' => metadata['description'], 'isPartOf' => { '@id' => website_id },
+          'inLanguage' => metadata['language'], 'datePublished' => metadata['date_published'],
+          'dateModified' => metadata['date_modified']
+        }.compact
+        if metadata['image']
+          webpage['primaryImageOfPage'] = { '@id' => "#{metadata['image']['url']}#primaryimage" }
+        end
+
+        breadcrumbs = breadcrumb_graph(item, metadata['canonical_url'], root_url)
+        if breadcrumbs
+          webpage['breadcrumb'] = { '@id' => "#{metadata['canonical_url']}#breadcrumb" }
+          graph << breadcrumbs
+        end
+        graph << webpage
+
+        if article_type
+          article_id = "#{metadata['canonical_url']}#article"
+          webpage['mainEntity'] = { '@id' => article_id }
+          article = {
+            '@type' => schema_type, '@id' => article_id,
+            'mainEntityOfPage' => { '@id' => webpage_id }, 'isPartOf' => { '@id' => website_id },
+            'headline' => metadata['page_title'], 'description' => metadata['description'],
+            'inLanguage' => metadata['language'], 'datePublished' => metadata['date_published'],
+            'dateModified' => metadata['date_modified']
+          }.compact
+          article['image'] = { '@id' => "#{metadata['image']['url']}#primaryimage" } if metadata['image']
+          article['author'] = person_reference(metadata['author']) if metadata['author']
+          article['publisher'] = { '@id' => "#{root_url}#identity" } if publisher
+          graph << article
+        end
+
+        safe_json('@context' => 'https://schema.org', '@graph' => graph)
+      end
+
+      def breadcrumb_graph(item, canonical, root_url)
+        return nil if item.url == '/'
+
+        ancestors = breadcrumb_ancestors(item)
+        entries = [{ 'name' => site_title(item.site), 'item' => root_url }]
+        ancestors.each do |ancestor|
+          entries << { 'name' => clean_text(ancestor.data['title']), 'item' => absolute_url(item.site, ancestor.url) }
+        end
+        entries << { 'name' => clean_text(item.data['title'] || site_title(item.site)), 'item' => canonical }
+        entries.reject! { |entry| entry['name'].to_s.empty? || entry['item'].to_s.empty? }
+        return nil if entries.length < 2
+
+        {
+          '@type' => 'BreadcrumbList', '@id' => "#{canonical}#breadcrumb",
+          'itemListElement' => entries.each_with_index.map do |entry, index|
+            { '@type' => 'ListItem', 'position' => index + 1, 'name' => entry['name'], 'item' => entry['item'] }
+          end
+        }
+      end
+
+      def breadcrumb_ancestors(item)
+        return [] unless item.respond_to?(:collection) && item.collection
+
+        docs = item.collection.docs
+        ancestors = []
+        current = item
+        seen = []
+        while (parent = Sidebar.parent_doc_for(current, docs)) && !seen.include?(parent)
+          seen << parent
+          ancestors.unshift(parent)
+          current = parent
+        end
+        ancestors
+      end
+
+      def generate_discovery_files(site, items)
+        config = config_for(site)
+        return unless config.is_a?(Hash)
+
+        site_url = absolute_url(site, '/')
+        if sitemap_enabled?(config) && !custom_output?(site, 'sitemap.xml') && absolute?(site_url)
+          site.pages << GeneratedPage.new(site, 'sitemap.xml', sitemap_xml(items))
+        end
+
+        return if config.fetch('robots_txt', true) == false || custom_output?(site, 'robots.txt')
+
+        site.pages << GeneratedPage.new(site, 'robots.txt', robots_txt(site, config, site_url))
+      end
+
+      def sitemap_xml(items)
+        rows = items.filter_map do |item|
+          metadata = item.data['_seo']
+          next unless sitemap_candidate?(item, metadata)
+
+          last_modified = metadata['date_modified']
+          last_modified ||= metadata['date_published'] if posts_document?(item)
+          [metadata['canonical_url'], last_modified]
+        end
+        rows.uniq!(&:first)
+        rows.sort_by!(&:first)
+
+        body = rows.map do |url, last_modified|
+          lastmod = last_modified ? "\n    <lastmod>#{xml_escape(last_modified)}</lastmod>" : ''
+          "  <url>\n    <loc>#{xml_escape(url)}</loc>#{lastmod}\n  </url>"
+        end.join("\n")
+
+        <<~XML
+          <?xml version="1.0" encoding="UTF-8"?>
+          <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+          #{body}
+          </urlset>
+        XML
+      end
+
+      def robots_txt(site, config, site_url)
+        index = config.fetch('index', true) != false
+        lines = ['User-agent: *', index ? 'Allow: /' : 'Disallow: /']
+        lines << 'Disallow: /*.md$' if index && CopyPage.site_enabled?(site)
+        additional = config['robots_txt_rules']
+        lines.push('', additional.to_s.strip) unless additional.to_s.strip.empty?
+        sitemap_url = absolute_url(site, '/sitemap.xml')
+        if sitemap_enabled?(config) && absolute?(site_url) && sitemap_url
+          lines.push('', "Sitemap: #{sitemap_url}")
+        end
+        "#{lines.join("\n")}\n"
+      end
+
+      def sitemap_candidate?(item, metadata)
+        return false unless metadata.is_a?(Hash)
+        return false if item.data['sitemap'] == false || item.data['redirect_to'] || item.data['_seo_disabled']
+        return false if ['/404.html', '/404/'].include?(item.url)
+
+        robot_tokens = metadata['robots'].to_s.downcase.split(',').map(&:strip)
+        return false if robot_tokens.intersect?(%w[noindex none])
+
+        canonical = metadata['canonical_url']
+        self_url = absolute_url(item.site, item.url)
+        absolute?(canonical) && canonical == self_url
+      end
+
+      def html_items(site)
+        pages = site.pages.select { |page| page.output_ext == '.html' }
+        docs = site.collections.values.reject { |collection| collection.metadata['output'] == false }.flat_map(&:docs)
+        (pages + docs).uniq
+      end
+
+      def custom_output?(site, name)
+        expected = "/#{name}"
+        (site.pages + site.static_files).any? do |item|
+          item.url == expected || (item.respond_to?(:relative_path) && item.relative_path == expected)
+        end
+      end
+
+      def warn_about_metadata(site, items)
+        root = absolute_url(site, '/')
+        unless absolute?(root)
+          Jekyll.logger.warn(
+            'jekyll-vitepress-theme',
+            'Set an absolute `url` in _config.yml to emit canonical URLs, JSON-LD, sitemap.xml, and robots.txt discovery.'
+          )
+        end
+
+        enabled_items = items.reject { |item| item.data['_seo_disabled'] }
+        warn_for_items('Missing SEO title', enabled_items.select { |item| item.data.dig('_seo', 'page_title').to_s.empty? })
+        warn_for_items('Missing SEO description', enabled_items.select { |item| item.data.dig('_seo', 'description').to_s.empty? })
+
+        duplicate_titles = enabled_items.group_by { |item| item.data.dig('_seo', 'title') }
+                                        .select { |title, matches| !title.to_s.empty? && matches.length > 1 }
+        duplicate_titles.each do |title, matches|
+          paths = matches.first(5).map { |item| item.path || item.url }.join(', ')
+          Jekyll.logger.warn('jekyll-vitepress-theme', "Duplicate SEO title '#{title}': #{paths}")
+        end
+
+        duplicate_descriptions = enabled_items.group_by { |item| item.data.dig('_seo', 'description') }
+                                              .select { |description, matches| !description.to_s.empty? && matches.length > 1 }
+        duplicate_descriptions.each do |description, matches|
+          paths = matches.first(5).map { |item| item.path || item.url }.join(', ')
+          Jekyll.logger.warn('jekyll-vitepress-theme', "Duplicate SEO description '#{description}': #{paths}")
+        end
+      end
+
+      def warn_for_items(label, items)
+        return if items.empty?
+
+        paths = items.first(5).map { |item| item.path || item.url }.join(', ')
+        suffix = items.length > 5 ? " (and #{items.length - 5} more)" : ''
+        Jekyll.logger.warn('jekyll-vitepress-theme', "#{label}: #{paths}#{suffix}")
+      end
+
+      def locale_for(item)
+        value = item.data['locale'] || item.data['lang'] || item.site.config['locale'] || item.site.config['lang'] || 'en-US'
+        clean_text(value) || 'en-US'
+      end
+
+      def site_title(site)
+        branding = site.config.dig('jekyll_vitepress', 'branding')
+        clean_text(site.config['title'] || (branding['site_title'] if branding.is_a?(Hash)))
+      end
+
+      def absolute_url(site, value)
+        return nil if value.nil? || value == false
+
+        string = value.to_s.strip
+        return nil if string.empty?
+        return string if absolute?(string)
+
+        base = site.config['url'].to_s.strip.sub(%r{/+\z}, '')
+        return nil if base.empty?
+
+        baseurl = site.config['baseurl'].to_s.strip
+        baseurl = '' if baseurl == '/'
+        baseurl = "/#{baseurl}" unless baseurl.empty? || baseurl.start_with?('/')
+        baseurl = baseurl.sub(%r{/+\z}, '')
+        path = "/#{string}" unless string.start_with?('/')
+        path ||= string
+        "#{base}#{baseurl}#{path}".sub(%r{/index\.html\z}, '/').sub(%r{/+\z}, '/')
+      end
+
+      def canonical_url(site, value)
+        url = absolute_url(site, value)
+        return nil unless url
+
+        uri = URI.parse(url)
+        uri.fragment = nil
+        uri.to_s
+      rescue URI::InvalidURIError
+        nil
+      end
+
+      def sitemap_enabled?(config)
+        config.fetch('index', true) != false && config.fetch('sitemap', true) != false
+      end
+
+      def absolute?(value)
+        uri = URI.parse(value.to_s)
+        uri.is_a?(URI::HTTP) && uri.host
+      rescue URI::InvalidURIError
+        false
+      end
+
+      def clean_text(value)
+        return nil if value.nil? || value == false
+
+        text = value.to_s.gsub(/\[([^\]]+)\]\([^)]+\)/, '\\1')
+                    .gsub(/<[^>]*>/, ' ')
+                    .gsub(/[`*~]/, '')
+                    .gsub(/\s+/, ' ')
+                    .strip
+        text = CGI.unescapeHTML(text)
+        text.empty? ? nil : text
+      end
+
+      def positive_integer(value)
+        integer = Integer(value, exception: false)
+        integer if integer&.positive?
+      end
+
+      def twitter_handle(value)
+        handle = clean_text(value)
+        handle ? "@#{handle.delete_prefix('@')}" : nil
+      end
+
+      def hash_value(value)
+        value.is_a?(Hash) ? value : {}
+      end
+
+      def posts_document?(item)
+        item.respond_to?(:collection) && item.collection&.label == 'posts'
+      end
+
+      def person_reference(author)
+        value = { '@type' => 'Person', 'name' => author['name'] }
+        value['url'] = author['url'] if author['url']
+        value
+      end
+
+      def xml_time(value)
+        return nil if value.nil? || value == false
+        return value if value.is_a?(String) && value.match?(/\A\d{4}-\d{2}-\d{2}\z/)
+
+        time = value.respond_to?(:to_time) ? value.to_time : Time.parse(value.to_s)
+        time.xmlschema
+      rescue ArgumentError, TypeError
+        nil
+      end
+
+      def safe_json(value)
+        JSON.generate(value).gsub('<', '\\u003c').gsub('>', '\\u003e').gsub('&', '\\u0026')
+      end
+
+      def xml_escape(value)
+        CGI.escapeHTML(value.to_s)
+      end
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/ModuleLength
+  end
+end

data/lib/jekyll/vitepress_theme/version.rb

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

data/lib/jekyll-vitepress-theme.rb

@@ -1,3 +1,5 @@
 require 'jekyll'
 require_relative 'jekyll/vitepress_theme/version'
+require_relative 'jekyll/vitepress_theme/seo'
+require_relative 'jekyll/vitepress_theme/llms'
 require_relative 'jekyll/vitepress_theme/hooks'

metadata

@@ -1,15 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-vitepress-theme
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.9.0
 platform: ruby
 authors:
 - Carmine Paolino
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cgi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: jekyll
   requirement: !ruby/object:Gem::Requirement
@@ -50,8 +70,8 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '5.0'
-description: Jekyll VitePress Theme brings the VitePress default theme look and behavior
-  to Jekyll sites.
+description: Jekyll VitePress Theme brings VitePress-style documentation UX, search,
+  structured metadata, and Jekyll-native extensions to Ruby static sites.
 email:
 - carmine@paolino.me
 executables: []
@@ -78,6 +98,7 @@ files:
 - _includes/nav_social_links.html
 - _includes/rubygems_downloads_button.html
 - _includes/search.html
+- _includes/seo.html
 - _includes/sidebar.html
 - _includes/sidebar_items.html
 - _includes/version_link.html
@@ -156,6 +177,8 @@ files:
 - assets/vendor/turbo.js
 - lib/jekyll-vitepress-theme.rb
 - lib/jekyll/vitepress_theme/hooks.rb
+- lib/jekyll/vitepress_theme/llms.rb
+- lib/jekyll/vitepress_theme/seo.rb
 - lib/jekyll/vitepress_theme/version.rb
 homepage: https://jekyll-vitepress.dev
 licenses:
@@ -186,5 +209,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: A VitePress-like docs theme for Jekyll.
+summary: A polished, SEO-ready VitePress-style documentation theme for Jekyll.
 test_files: []