jekyll-theme-zer0 1.31.1 → 1.31.3

data/_includes/analytics/posthog.html

@@ -79,9 +79,13 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
 
   {% comment %} Consent gate (privacy.require_consent): until the visitor
      accepts the "analytics" category in the theme's cookie-consent banner
-     (localStorage "zer0-cookie-consent"), PostHog starts opted OUT with
-     memory-only persistence — no cookies, nothing stored. The banner's
-     applyConsent() flips opt-in/opt-out live once a choice is made. {% endcomment %}
+     (localStorage "zer0-cookie-consent"), PostHog is not loaded at all: no
+     request to PostHog and no ph_* cookie or localStorage entry. It used to
+     load opted-out with memory persistence, which still fetched array.js,
+     config.js and surveys.js before any choice was made. Accepting dispatches
+     `cookieConsentChanged`; the listener below then boots PostHog on the spot,
+     so no reload is needed. Reject keeps it off. Same record and 365-day
+     expiry as components/cookie-consent.html. {% endcomment %}
   window.__phHasAnalyticsConsent = true;
   if (window.posthogConfig.requireConsent) {
     window.__phHasAnalyticsConsent = false;
@@ -89,9 +93,10 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
       var __phStored = window.localStorage.getItem('zer0-cookie-consent');
       if (__phStored) {
         var __phConsent = JSON.parse(__phStored);
-        window.__phHasAnalyticsConsent = __phConsent && __phConsent.analytics === true;
+        window.__phHasAnalyticsConsent = !!(__phConsent && __phConsent.analytics === true &&
+          (Date.now() - __phConsent.timestamp) <= 365 * 864e5);
       }
-    } catch (e) { /* localStorage unavailable — stay opted out */ }
+    } catch (e) { /* localStorage unavailable — stay off */ }
   }
 
   {% comment %} Honor browser privacy signals before loading: Do Not Track
@@ -100,83 +105,102 @@ Privacy: Respects Do Not Track and provides opt-out mechanisms
       (window.posthogConfig.respectGpc && window.navigator.globalPrivacyControl === true)) {
     console.log('PostHog: respecting browser privacy signal (DNT/GPC)');
   } else {
-    {% comment %} Deferred loading: the stub below is installed immediately, so
-       posthog.capture()/opt_in_capturing() calls (e.g. from the cookie
-       banner) queue as before, but the ~130 KB library (array.js, then
-       config.js/surveys.js) is only fetched after the window `load` event
-       and the next idle period. It used to be inserted while the page was
-       still parsing and competed with first paint on mobile. The snippet is
-       PostHog's official one; the only change is that its insertBefore()
-       runs through __phInject. {% endcomment %}
-    window.__phInject = function (insert) {
-      var run = function () {
-        if (window.requestIdleCallback) window.requestIdleCallback(insert, { timeout: 3000 });
-        else setTimeout(insert, 1);
+    {% comment %} Everything that loads or configures PostHog runs in __phBoot,
+       once: at parse time when consent is not required or was already
+       given, otherwise when the visitor accepts analytics. {% endcomment %}
+    var __phBoot = function () {
+      if (window.__phBooted) return;
+      window.__phBooted = true;
+      {% comment %} Deferred loading: the stub below is installed immediately, so
+         posthog.capture()/opt_in_capturing() calls (e.g. from the cookie
+         banner) queue as before, but the ~130 KB library (array.js, then
+         config.js/surveys.js) is only fetched after the window `load` event
+         and the next idle period. It used to be inserted while the page was
+         still parsing and competed with first paint on mobile. The snippet is
+         PostHog's official one; the only change is that its insertBefore()
+         runs through __phInject. {% endcomment %}
+      window.__phInject = function (insert) {
+        var run = function () {
+          if (window.requestIdleCallback) window.requestIdleCallback(insert, { timeout: 3000 });
+          else setTimeout(insert, 1);
+        };
+        if (document.readyState === 'complete') run();
+        else window.addEventListener('load', run, { once: true });
       };
-      if (document.readyState === 'complete') run();
-      else window.addEventListener('load', run, { once: true });
-    };
-    {% comment %} PostHog Loading Script {% endcomment %}
-    !function(t,e){var o,n,p,r;e.__SV||(window.posthog && window.posthog.__loaded)||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",window.__phInject(function(){(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r)});var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="init Rr Mr fi Or Ar ci Tr Cr capture Mi calculateEventProperties Lr register register_once register_for_session unregister unregister_for_session Hr getFeatureFlag getFeatureFlagPayload isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSurveysLoaded onSessionId getSurveys getActiveMatchingSurveys renderSurvey displaySurvey canRenderSurvey canRenderSurveyAsync identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty Ur jr createPersonProfile zr kr Br opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing get_explicit_consent_status is_capturing clear_opt_in_out_capturing Dr debug M Nr getPageViewId captureTraceFeedback captureTraceMetric $r".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
+      {% comment %} PostHog Loading Script {% endcomment %}
+      !function(t,e){var o,n,p,r;e.__SV||(window.posthog && window.posthog.__loaded)||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",window.__phInject(function(){(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r)});var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="init Rr Mr fi Or Ar ci Tr Cr capture Mi calculateEventProperties Lr register register_once register_for_session unregister unregister_for_session Hr getFeatureFlag getFeatureFlagPayload isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSurveysLoaded onSessionId getSurveys getActiveMatchingSurveys renderSurvey displaySurvey canRenderSurvey canRenderSurveyAsync identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty Ur jr createPersonProfile zr kr Br opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing get_explicit_consent_status is_capturing clear_opt_in_out_capturing Dr debug M Nr getPageViewId captureTraceFeedback captureTraceMetric $r".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
 
-    {% comment %} Initialize PostHog with configuration {% endcomment %}
-    posthog.init(window.posthogConfig.apiKey, {
-      api_host: window.posthogConfig.apiHost,
-      person_profiles: window.posthogConfig.personProfiles,
-      autocapture: window.posthogConfig.autocapture,
-      capture_pageview: window.posthogConfig.capturePageview,
-      capture_pageleave: window.posthogConfig.capturePageleave,
-      disable_cookie: window.posthogConfig.disableCookie,
-      cross_subdomain_cookie: window.posthogConfig.crossSubdomainCookie,
-      secure_cookie: window.posthogConfig.secureCookie,
-      persistence: window.__phHasAnalyticsConsent ? window.posthogConfig.persistence : 'memory',
-      opt_out_capturing_by_default: !window.__phHasAnalyticsConsent,
-      session_recording: window.posthogConfig.sessionRecording,
-      {% if site.posthog.privacy.ip_anonymization %}
-      ip: false,
-      {% endif %}
-      loaded: function(posthog) {
-        {% comment %} PostHog loaded successfully {% endcomment %}
-        console.log('PostHog analytics loaded successfully');
+      {% comment %} Initialize PostHog with configuration {% endcomment %}
+      posthog.init(window.posthogConfig.apiKey, {
+        api_host: window.posthogConfig.apiHost,
+        person_profiles: window.posthogConfig.personProfiles,
+        autocapture: window.posthogConfig.autocapture,
+        capture_pageview: window.posthogConfig.capturePageview,
+        capture_pageleave: window.posthogConfig.capturePageleave,
+        disable_cookie: window.posthogConfig.disableCookie,
+        cross_subdomain_cookie: window.posthogConfig.crossSubdomainCookie,
+        secure_cookie: window.posthogConfig.secureCookie,
+        persistence: window.__phHasAnalyticsConsent ? window.posthogConfig.persistence : 'memory',
+        opt_out_capturing_by_default: !window.__phHasAnalyticsConsent,
+        session_recording: window.posthogConfig.sessionRecording,
+        {% if site.posthog.privacy.ip_anonymization %}
+        ip: false,
+        {% endif %}
+        loaded: function(posthog) {
+          {% comment %} PostHog loaded successfully {% endcomment %}
+          console.log('PostHog analytics loaded successfully');
 
-        {% comment %} privacy.geoip_disable: stop PostHog from resolving
-           IP to location on every event {% endcomment %}
-        if (window.posthogConfig.geoipDisable) {
-          posthog.register({ '$geoip_disable': true });
-        }
+          {% comment %} privacy.geoip_disable: stop PostHog from resolving
+             IP to location on every event {% endcomment %}
+          if (window.posthogConfig.geoipDisable) {
+            posthog.register({ '$geoip_disable': true });
+          }
 
-        {% comment %} Track Jekyll-specific page properties. Free-text values go
-           through `jsonify`: they used to be pasted between single quotes, so
-           an apostrophe in a title or description ("you're") was a
-           SyntaxError that stopped PostHog loading at all. {% endcomment %}
-        posthog.register({
-          'site_title': {{ site.title | jsonify }},
-          'site_description': {{ site.description | strip_newlines | strip | jsonify }},
-          'jekyll_version': '{{ jekyll.version }}',
-          'theme': {{ site.remote_theme | default: site.theme | jsonify }},
-          'page_layout': {{ page.layout | jsonify }},
-          'page_collection': {{ page.collection | jsonify }},
-          {% if page.categories %}
-          'page_categories': {{ page.categories | jsonify }},
-          {% endif %}
-          {% if page.tags %}
-          'page_tags': {{ page.tags | jsonify }},
-          {% endif %}
-          'page_url': window.location.pathname,
-          'page_title': {{ page.title | strip_newlines | strip | jsonify }},
-          'page_author': {{ page.author | default: site.author.name | jsonify }},
-          {% if page.date %}
-          'page_date': '{{ page.date | date: "%Y-%m-%d" }}',
-          {% endif %}
-          'user_agent': navigator.userAgent,
-          'screen_resolution': screen.width + 'x' + screen.height,
-          'viewport_size': window.innerWidth + 'x' + window.innerHeight
-        });
+          {% comment %} Track Jekyll-specific page properties. Free-text values go
+             through `jsonify`: they used to be pasted between single quotes, so
+             an apostrophe in a title or description ("you're") was a
+             SyntaxError that stopped PostHog loading at all. {% endcomment %}
+          posthog.register({
+            'site_title': {{ site.title | jsonify }},
+            'site_description': {{ site.description | strip_newlines | strip | jsonify }},
+            'jekyll_version': '{{ jekyll.version }}',
+            'theme': {{ site.remote_theme | default: site.theme | jsonify }},
+            'page_layout': {{ page.layout | jsonify }},
+            'page_collection': {{ page.collection | jsonify }},
+            {% if page.categories %}
+            'page_categories': {{ page.categories | jsonify }},
+            {% endif %}
+            {% if page.tags %}
+            'page_tags': {{ page.tags | jsonify }},
+            {% endif %}
+            'page_url': window.location.pathname,
+            'page_title': {{ page.title | strip_newlines | strip | jsonify }},
+            'page_author': {{ page.author | default: site.author.name | jsonify }},
+            {% if page.date %}
+            'page_date': '{{ page.date | date: "%Y-%m-%d" }}',
+            {% endif %}
+            'user_agent': navigator.userAgent,
+            'screen_resolution': screen.width + 'x' + screen.height,
+            'viewport_size': window.innerWidth + 'x' + window.innerHeight
+          });
 
-        {% comment %} Initialize custom event tracking {% endcomment %}
-        initializeCustomTracking();
-      }
-    });
+          {% comment %} Initialize custom event tracking {% endcomment %}
+          initializeCustomTracking();
+        }
+      });
+    };
+
+    if (window.__phHasAnalyticsConsent) {
+      __phBoot();
+    } else {
+      document.addEventListener('cookieConsentChanged', function (e) {
+        if (!(e.detail && e.detail.analytics === true) || window.__phBooted) return;
+        window.__phHasAnalyticsConsent = true;
+        __phBoot();
+        {% comment %} Clears an opt-out a previous Reject may have stored. {% endcomment %}
+        window.posthog.opt_in_capturing();
+      });
+    }
   }
 
   {% comment %} Custom Event Tracking Functions {% endcomment %}

data/_includes/components/ai-chat.html

@@ -185,7 +185,7 @@
   "authMode": {{ ai_auth_mode | jsonify }},
   "apiKey": {{ site.ai_chat.api_key | jsonify }},
   "anthropicVersion": {{ site.ai_chat.anthropic_version | default: "2023-06-01" | jsonify }},
-  "model": {{ site.ai_chat.model | default: "claude-opus-4-8" | jsonify }},
+  "model": {{ site.ai_chat.model | default: "claude-opus-5-5" | jsonify }},
   "maxTokens": {{ site.ai_chat.max_tokens | default: 1024 }},
   "strictContext": {{ site.ai_chat.strict_context | default: true | jsonify }},
   "outOfScopeMessage": {{ site.ai_chat.out_of_scope_message | default: "I can only answer from the content on this page." | jsonify }},

data/_includes/components/cookie-consent.html

@@ -249,6 +249,33 @@ Configuration: Uses site.posthog settings from _config.yml
       }));
     }
 
+    // Reserve the banner's height while it is up. Publishes it as
+    // --zer0-cookie-banner-inset on <html> plus the zer0-cookie-banner-open
+    // class; _sass/components/_cookie-banner.scss turns that into body
+    // padding, scroll-padding-bottom (keyboard focus scrolls clear of the
+    // banner) and a lift for the floating buttons, which used to sit under
+    // it. A ResizeObserver keeps it right when the banner reflows (94px on
+    // phones, 48px from md up). Set as soon as the banner is unhidden, before
+    // the 1s slide-in, so the page does not shift when it appears.
+    let insetObserver = null;
+    function setBannerInset(banner) {
+      const root = document.documentElement;
+      const apply = () => {
+        root.style.setProperty('--zer0-cookie-banner-inset', Math.ceil(banner.offsetHeight) + 'px');
+        root.classList.add('zer0-cookie-banner-open');
+      };
+      apply();
+      if (!insetObserver && 'ResizeObserver' in window) {
+        insetObserver = new ResizeObserver(apply);
+        insetObserver.observe(banner);
+      }
+    }
+    function clearBannerInset() {
+      if (insetObserver) { insetObserver.disconnect(); insetObserver = null; }
+      document.documentElement.classList.remove('zer0-cookie-banner-open');
+      document.documentElement.style.removeProperty('--zer0-cookie-banner-inset');
+    }
+
     // Show consent banner
     function showConsentBanner() {
       const banner = document.getElementById('cookieConsent');
@@ -257,6 +284,7 @@ Configuration: Uses site.posthog settings from _config.yml
       // Reveal the element (CSS keeps it translated off-screen + opacity:0).
       banner.hidden = false;
       banner.classList.remove('cookie-banner-visible');
+      setBannerInset(banner);
 
       setTimeout(() => {
         // Force reflow so the next class change actually animates.
@@ -277,6 +305,7 @@ Configuration: Uses site.posthog settings from _config.yml
         if (done) return;
         done = true;
         banner.hidden = true;
+        clearBannerInset();
         banner.removeEventListener('transitionend', onEnd);
       };
       const onEnd = (e) => {

data/_includes/components/page-feedback.html

@@ -280,7 +280,7 @@
   "ai": {
     "available": {{ pf_ai_available | jsonify }},
     "auto": {{ site.page_feedback.ai.auto | default: false | jsonify }},
-    "model": {{ site.page_feedback.ai.model | default: "claude-opus-4-8" | jsonify }},
+    "model": {{ site.page_feedback.ai.model | default: "claude-opus-5-5" | jsonify }},
     "maxTokens": {{ site.page_feedback.ai.max_tokens | default: 1024 }}
   }
 }

data/_includes/content/intro.html

@@ -111,6 +111,20 @@
   {% endif %}
 {% endif %}
 
+{% comment %} Tags index existence gate (issue #537) — the same policy as
+   news.html / section.html: an explicit site.tags_page is trusted; otherwise
+   link only when a page at /tags/ is actually in the build. A remote-theme
+   consumer without the tags index gets plain badges instead of 404 links on
+   every tagged page. {% endcomment %}
+{% assign intro_tags_base = site.tags_page | default: "/tags/" %}
+{% assign intro_tags_linkable = false %}
+{% if site.tags_page %}
+  {% assign intro_tags_linkable = true %}
+{% else %}
+  {% assign intro_tags_index = site.html_pages | where: "url", intro_tags_base | first %}
+  {% if intro_tags_index %}{% assign intro_tags_linkable = true %}{% endif %}
+{% endif %}
+
 {% comment %} Category or collection badge (most specific category wins) {% endcomment %}
 {% assign intro_category = nil %}
 {% assign intro_category_url = nil %}
@@ -129,7 +143,9 @@
     {% capture intro_category_url %}{{ site.baseurl }}/docs/{{ intro_category_slug }}/{% endcapture %}
   {% else %}
     {% assign intro_category_slug = intro_category | append: '' | slugify %}
-    {% capture intro_category_url %}{{ '/tags/' | relative_url }}#{{ intro_category_slug }}{% endcapture %}
+    {% if intro_tags_linkable %}
+      {% capture intro_category_url %}{{ intro_tags_base | relative_url }}#{{ intro_category_slug }}{% endcapture %}
+    {% endif %}
   {% endif %}
 {% elsif page.collection and page.collection != "pages" %}
   {% assign intro_category = page.collection %}
@@ -217,7 +233,11 @@
           <span class="bd-intro-tag-list">
             {% for tag in page.tags limit: 5 %}
             {% assign intro_tag_label = tag | append: '' %}
-            <a class="bd-intro-badge bd-intro-badge--tag" href="{{ '/tags/' | relative_url }}#{{ intro_tag_label | slugify }}">{{ intro_tag_label }}</a>
+            {% if intro_tags_linkable %}
+            <a class="bd-intro-badge bd-intro-badge--tag" href="{{ intro_tags_base | relative_url }}#{{ intro_tag_label | slugify }}">{{ intro_tag_label }}</a>
+            {% else %}
+            <span class="bd-intro-badge bd-intro-badge--tag">{{ intro_tag_label }}</span>
+            {% endif %}
             {% endfor %}
             {% if page.tags.size > 5 %}
             <span class="bd-intro-badge bd-intro-badge--tag bd-intro-badge--more">+{{ page.tags.size | minus: 5 }}</span>

data/_includes/content/sitemap.html

@@ -211,11 +211,20 @@
                         <tbody id="sitemapTableBody">
                             {% assign total_pages = 0 %}
                             {% assign collections_data = '' %}
+                            {% comment %}
+                              Only the first page of rows is rendered as HTML, which is enough
+                              for no-JS visitors and first paint. Every row (these included) is
+                              also in the compact #sitemapData JSON below, and the script builds
+                              the other rows from it when they are needed. With 431 rows on
+                              it-journey.dev, rendering them all made /search/ 2.2 MB of HTML.
+                            {% endcomment %}
+                            {% assign sitemap_server_rows = 50 %}
                             
                             {% comment %}Loose Jekyll pages (site.pages in Liquid is the "pages" collection, not these files){% endcomment %}
                             {% for page in site.html_pages %}
                                 {% unless page.sitemap == false %}
                                     {% assign total_pages = total_pages | plus: 1 %}
+                                    {% if total_pages <= sitemap_server_rows %}
                                     <tr data-collection="pages" 
                                         data-title="{{ page.title | default: page.name | escape }}"
                                         data-description="{{ page.description | escape }}"
@@ -281,6 +290,7 @@
                                             </div>
                                         </td>
                                     </tr>
+                                    {% endif %}
                                 {% endunless %}
                             {% endfor %}
                             
@@ -289,6 +299,7 @@
                                 {% for item in collection.docs %}
                                     {% unless item.sitemap == false %}
                                         {% assign total_pages = total_pages | plus: 1 %}
+                                        {% if total_pages <= sitemap_server_rows %}
                                         <tr data-collection="{{ collection.label }}" 
                                             data-title="{{ item.title | escape }}"
                                             data-description="{{ item.description | escape }}"
@@ -354,6 +365,7 @@
                                                 </div>
                                             </td>
                                         </tr>
+                                        {% endif %}
                                     {% endunless %}
                                 {% endfor %}
                             {% endfor %}
@@ -365,6 +377,43 @@
     </div>
 </div>
 
+{% comment %}
+  Row data for the whole index, one compact entry per row in the same order
+  as the loops above. Keys: c collection, cl collection label, t title,
+  d description, x description cell text (description or excerpt),
+  cat/tag arrays, dt ISO date, dl display date, u url. "</" is escaped so
+  a title can't close the script element early.
+{% endcomment %}
+{%- capture sitemap_json -%}
+[
+{%- assign sm_first = true -%}
+{%- for page in site.html_pages -%}
+{%- unless page.sitemap == false -%}
+{%- unless sm_first %},{% endunless -%}{%- assign sm_first = false -%}
+{"c":"pages","cl":"Pages","t":{{ page.title | default: page.name | jsonify }},"d":{{ page.description | default: "" | jsonify }},"x":{{ page.description | default: "No description available" | jsonify }},"cat":{{ page.categories | default: empty | jsonify }},"tag":{{ page.tags | default: empty | jsonify }},"dt":{{ page.lastmod | default: page.date | date: '%Y-%m-%d' | jsonify }},"dl":{{ page.lastmod | default: page.date | date: "%b %d, %Y" | default: "Unknown" | jsonify }},"u":{{ page.url | relative_url | jsonify }}}
+{%- endunless -%}
+{%- endfor -%}
+{%- for collection in site.collections -%}
+{%- assign sm_label = collection.label | capitalize -%}
+{%- for item in collection.docs -%}
+{%- unless item.sitemap == false -%}
+{%- unless sm_first %},{% endunless -%}{%- assign sm_first = false -%}
+{"c":{{ collection.label | jsonify }},"cl":{{ sm_label | jsonify }},"t":{{ item.title | default: "" | jsonify }},"d":{{ item.description | default: "" | jsonify }},"x":{{ item.description | default: item.excerpt | strip_html | default: "No description available" | jsonify }},"cat":{{ item.categories | default: empty | jsonify }},"tag":{{ item.tags | default: empty | jsonify }},"dt":{{ item.lastmod | default: item.date | date: '%Y-%m-%d' | jsonify }},"dl":{{ item.lastmod | default: item.date | date: "%b %d, %Y" | default: "Unknown" | jsonify }},"u":{{ item.url | relative_url | jsonify }}}
+{%- endunless -%}
+{%- endfor -%}
+{%- endfor -%}
+]
+{%- endcapture -%}
+<script type="application/json" id="sitemapData" data-site-url="{{ site.url }}" data-server-rows="{{ sitemap_server_rows }}">{{ sitemap_json | replace: "</", "<\/" }}</script>
+{%- if total_pages > sitemap_server_rows %}
+<noscript>
+    <p class="text-center text-muted mt-3">
+        Showing the first {{ sitemap_server_rows }} of {{ total_pages }} pages. Turn on JavaScript to search and page through all of them
+        {%- if site.plugins contains 'jekyll-sitemap' or site.gems contains 'jekyll-sitemap' %}, or browse the full list in the <a href="{{ '/sitemap.xml' | relative_url }}">XML sitemap</a>{% endif %}.
+    </p>
+</noscript>
+{%- endif %}
+
 {% comment %} ================================ {% endcomment %}
 {% comment %} CARDS VIEW CONTAINER            {% endcomment %}
 {% comment %} ================================ {% endcomment %}
@@ -474,13 +523,17 @@ th:hover .sort-icon {
  * Enhanced Sitemap Functionality
  * Features: Advanced search, sorting, filtering, statistics, and card/table views
  *
- * Paginated: every row is still rendered server-side (so the index works
- * without JS and with ?q= from the search modal's "View all results"), but
- * only PAGE_SIZE matching rows stay in the document; the rest are kept in
- * memory and a "Show more" button appends the next page. Cards are built on
- * the first switch to card view, one page at a time. On it-journey.dev the
- * index (431 rows plus 431 eagerly built cards) put ~19,900 elements on
- * /search/ before the visitor typed anything.
+ * Paginated: only PAGE_SIZE matching rows are in the document at a time,
+ * and a "Show more" button appends the next page. Cards are built on the
+ * first switch to card view, one page at a time.
+ *
+ * Only the first page of rows is rendered server-side, which is enough for
+ * no-JS visitors and first paint. Every row is described by a compact entry
+ * in #sitemapData, and this script builds the other <tr> elements from it
+ * the first time they are shown or sorted. Search and filters run on the
+ * entries, so ?q= from the search modal's "View all results" still covers
+ * the whole index. On it-journey.dev the full server-rendered table (431
+ * rows) made /search/ about 2.2 MB of HTML.
  */
 class SitemapManager {
     static PAGE_SIZE = 50;
@@ -503,7 +556,22 @@ class SitemapManager {
         this.showMoreWrap = document.getElementById('sitemapShowMore');
         this.showMoreBtn = document.getElementById('sitemapShowMoreBtn');
 
-        this.rows = Array.from(this.tbody.querySelectorAll('tr'));
+        // One entry per index row. `dataset` mirrors the <tr data-*> attributes
+        // so search, filters, stats and cards read entries and rows alike.
+        // The first rows reuse the server-rendered <tr>; the rest are built
+        // on demand by rowFor().
+        const serverRows = Array.from(this.tbody.querySelectorAll('tr'));
+        const dataEl = document.getElementById('sitemapData');
+        let data = [];
+        try {
+            data = dataEl ? JSON.parse(dataEl.textContent) : [];
+        } catch (error) {
+            console.warn('Sitemap: could not read #sitemapData', error);
+        }
+        this.siteUrl = dataEl ? (dataEl.dataset.siteUrl || '') : '';
+        this.rows = data.length
+            ? data.map((e, i) => this.entryFrom(e, serverRows[i] || null))
+            : serverRows.map(tr => ({ dataset: tr.dataset, row: tr }));
         this.visibleCount = document.getElementById('visibleCount');
         this.totalCount = document.getElementById('totalCount');
 
@@ -517,6 +585,91 @@ class SitemapManager {
         this.init();
     }
 
+    // Normalise one #sitemapData entry; `row` is its server-rendered <tr>, if any.
+    entryFrom(e, row) {
+        const list = v => Array.isArray(v) ? v.map(String) : (v ? [String(v)] : []);
+        const categories = list(e.cat);
+        const tags = list(e.tag);
+        return {
+            row,
+            raw: e,
+            categoriesList: categories,
+            tagsList: tags,
+            dataset: {
+                collection: e.c || '',
+                title: e.t || '',
+                description: e.d || '',
+                categories: categories.join(', '),
+                tags: tags.join(', '),
+                date: e.dt || '',
+                url: e.u || ''
+            }
+        };
+    }
+
+    // Liquid's `truncate`: at most n characters including the "..." suffix.
+    static truncate(text, n) {
+        const chars = Array.from(text || '');
+        return chars.length > n ? chars.slice(0, n - 3).join('') + '...' : chars.join('');
+    }
+
+    // The <tr> for an entry: the server-rendered one, or built once with
+    // the same markup the include renders (text set via textContent).
+    rowFor(entry) {
+        if (entry.row) return entry.row;
+        const e = entry.raw;
+        const d = entry.dataset;
+        const tr = document.createElement('tr');
+        Object.entries(d).forEach(([k, v]) => { tr.dataset[k] = v; });
+        const isPage = d.collection === 'pages';
+        tr.innerHTML = `
+            <td><span class="badge ${isPage ? 'text-bg-primary' : 'text-bg-info'} rounded-pill"></span></td>
+            <td><a class="text-decoration-none fw-medium"></a></td>
+            <td class="d-none d-md-table-cell"><small class="text-muted"></small></td>
+            <td><small class="text-muted"></small></td>
+            <td class="d-none d-lg-table-cell"></td>
+            <td class="d-none d-xl-table-cell"></td>
+            <td class="text-center">
+                <div class="btn-group btn-group-sm" role="group">
+                    <a class="btn btn-outline-primary btn-sm" title="View page"><i class="bi bi-eye"></i></a>
+                    <button class="btn btn-outline-secondary btn-sm copy-url" title="Copy URL"><i class="bi bi-clipboard"></i></button>
+                </div>
+            </td>`;
+        const cells = tr.children;
+        cells[0].firstElementChild.textContent = e.cl || d.collection;
+        const link = cells[1].firstElementChild;
+        link.href = d.url;
+        link.textContent = SitemapManager.truncate(d.title, 50);
+        if (d.description) {
+            const small = document.createElement('small');
+            small.className = 'text-muted d-md-none';
+            small.textContent = SitemapManager.truncate(d.description, 80);
+            cells[1].append(document.createElement('br'), small);
+        }
+        cells[2].firstElementChild.textContent = SitemapManager.truncate(e.x || 'No description available', 120);
+        cells[3].firstElementChild.textContent = e.dl || 'Unknown';
+        const chips = (cell, items, max, cls, prefix) => {
+            items.slice(0, max).forEach(item => {
+                const b = document.createElement('span');
+                b.className = `badge ${cls} me-1`;
+                b.textContent = prefix + item;
+                cell.append(b, ' ');
+            });
+            if (items.length > max) {
+                const more = document.createElement('span');
+                more.className = 'badge text-body-secondary border';
+                more.textContent = `+${items.length - max}`;
+                cell.append(more);
+            }
+        };
+        chips(cells[4], entry.categoriesList, 2, 'bg-secondary', '');
+        chips(cells[5], entry.tagsList, 3, 'bg-outline-primary', '#');
+        cells[6].querySelector('a').href = d.url;
+        cells[6].querySelector('.copy-url').dataset.url = this.siteUrl + d.url;
+        entry.row = tr;
+        return tr;
+    }
+
     init() {
         this.setupCollectionFilter();
         this.updateStatistics();
@@ -651,11 +804,11 @@ class SitemapManager {
             header.addEventListener('click', () => this.sortTable(header));
         });
 
-        // Copy URL functionality (table rows; cards bind their own)
-        this.rows.forEach(row => {
-            row.querySelectorAll('.copy-url').forEach(btn => {
-                btn.addEventListener('click', (e) => this.copyUrl(e));
-            });
+        // Copy URL functionality (table rows, delegated so rows built later
+        // work too; cards bind their own)
+        this.tbody.addEventListener('click', (e) => {
+            const btn = e.target.closest('.copy-url');
+            if (btn && this.tbody.contains(btn)) this.copyUrl({ currentTarget: btn });
         });
 
         // Keyboard shortcuts
@@ -729,7 +882,7 @@ class SitemapManager {
     render() {
         const shown = this.matches.slice(0, this.limit);
         if (this.currentView === 'table') {
-            this.tbody.replaceChildren(...shown);
+            this.tbody.replaceChildren(...shown.map(entry => this.rowFor(entry)));
         } else {
             this.cardsContainer.replaceChildren(...shown.map(row => this.cardFor(row)));
         }
@@ -760,10 +913,13 @@ class SitemapManager {
         const icon = header.querySelector('.sort-icon');
         icon.className = `sort-icon bi bi-arrow-${newOrder === 'asc' ? 'up' : 'down'} ms-1 active`;
 
-        // Sort every row (not just the rendered page), then re-render
+        // Sort every row (not just the rendered page), then re-render. Keys
+        // come from each row's cell text, so rows not built yet are built
+        // here (once, on the visitor's click).
+        const keys = new Map(this.rows.map(entry => [entry, this.rowFor(entry).children[headerIndex].textContent.trim()]));
         this.rows.sort((a, b) => {
-            let aValue = a.children[headerIndex].textContent.trim();
-            let bValue = b.children[headerIndex].textContent.trim();
+            let aValue = keys.get(a);
+            let bValue = keys.get(b);
 
             if (type === 'date') {
                 aValue = aValue === "Unknown" ? new Date(0) : new Date(aValue);