RubyGems - jekyll-theme-zer0 - Versions diffs - 1.28.0 → 1.30.0 - Mend

jekyll-theme-zer0 1.28.0 → 1.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (191) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +1143 -13
data/_data/README.md +2 -0
data/_data/ai.yml +5 -3
data/_data/ai_pricing.yml +36 -0
data/_data/backlog.yml +507 -2
data/_data/consumers.yml +157 -9
data/_data/features.yml +303 -20
data/_data/feedback_types.yml +17 -12
data/_data/i18n/fr.yml +12 -7
data/_data/i18n/manifest.yml +39 -12
data/_data/ingredient_densities.yml +122 -0
data/_data/landing.yml +5 -2
data/_data/navigation/main.yml +16 -0
data/_data/navigation/quickstart.yml +4 -0
data/_data/recipe_courses.yml +64 -0
data/_data/site_builder.yml +874 -0
data/_data/theme-manifest.yml +160 -124
data/_data/ui-text.yml +26 -0
data/_includes/README.md +26 -2
data/_includes/analytics/posthog.html +2 -2
data/_includes/components/admin-links.html +2 -2
data/_includes/components/admin-tabs.html +2 -2
data/_includes/components/ai-chat.html +14 -11
data/_includes/components/analytics-dashboard.html +8 -8
data/_includes/components/author-bio.html +1 -1
data/_includes/components/author-card.html +10 -2
data/_includes/components/author-eeat.html +4 -4
data/_includes/components/background-customizer.html +10 -10
data/_includes/components/background-image.html +114 -0
data/_includes/components/background-settings.html +28 -15
data/_includes/components/collection-manager.html +5 -5
data/_includes/components/component-showcase.html +13 -13
data/_includes/components/config-editor.html +12 -12
data/_includes/components/config-viewer.html +8 -8
data/_includes/components/cookie-consent.html +15 -15
data/_includes/components/cta-button.html +7 -2
data/_includes/components/dev-shortcuts.html +7 -7
data/_includes/components/env-dashboard.html +8 -8
data/_includes/components/env-switcher.html +9 -9
data/_includes/components/feature-card.html +2 -2
data/_includes/components/halfmoon.html +2 -2
data/_includes/components/info-section.html +42 -37
data/_includes/components/js-cdn.html +15 -15
data/_includes/components/language-toggle.html +168 -21
data/_includes/components/mermaid.html +72 -435
data/_includes/components/nanobar.html +5 -5
data/_includes/components/nav-editor.html +2 -2
data/_includes/components/nav-export.html +2 -2
data/_includes/components/nav-overview.html +2 -2
data/_includes/components/page-feedback.html +45 -30
data/_includes/components/page-views-init.html +55 -0
data/_includes/components/page-views.html +33 -0
data/_includes/components/post-card.html +22 -22
data/_includes/components/post-type-badge.html +2 -2
data/_includes/components/powered-by.html +2 -2
data/_includes/components/preview-image.html +6 -0
data/_includes/components/quick-index.html +2 -2
data/_includes/components/recipe-card.html +67 -0
data/_includes/components/recipe-duration.html +50 -0
data/_includes/components/recipe-grams.html +58 -0
data/_includes/components/recipe-index.html +96 -0
data/_includes/components/recipe-ingredients.html +90 -0
data/_includes/components/recipe-meta.html +96 -0
data/_includes/components/recipe-nutrition.html +57 -0
data/_includes/components/recipe-qty.html +73 -0
data/_includes/components/recipe-ratio.html +151 -0
data/_includes/components/recipe-scaler.html +73 -0
data/_includes/components/recipe-steps.html +86 -0
data/_includes/components/recipe-temp.html +45 -0
data/_includes/components/search-modal.html +29 -4
data/_includes/components/searchbar.html +2 -2
data/_includes/components/shortcuts-modal.html +3 -0
data/_includes/components/svg-background.html +2 -2
data/_includes/components/theme-customizer.html +2 -2
data/_includes/components/theme-info.html +14 -7
data/_includes/components/theme-preview-gallery.html +22 -22
data/_includes/content/giscus.html +2 -2
data/_includes/content/intro.html +8 -8
data/_includes/content/jsonld-faq.html +2 -2
data/_includes/content/jsonld-software.html +24 -5
data/_includes/content/seo.html +4 -4
data/_includes/content/sitemap.html +27 -27
data/_includes/content/toc.html +183 -183
data/_includes/core/branding.html +6 -6
data/_includes/core/console-capture.html +32 -74
data/_includes/core/favicon.html +49 -7
data/_includes/core/footer-fabs.html +17 -3
data/_includes/core/footer.html +49 -34
data/_includes/core/head.html +110 -86
data/_includes/core/header.html +76 -54
data/_includes/docs/bootstrap-docs.html +8 -8
data/_includes/landing/landing-install-cards.html +2 -2
data/_includes/landing/landing-quick-links.html +1 -1
data/_includes/navigation/admin-nav.html +2 -2
data/_includes/navigation/nav-tree.html +8 -8
data/_includes/navigation/navbar.html +12 -12
data/_includes/navigation/section-sidebar.html +109 -27
data/_includes/navigation/sidebar-config.html +36 -2
data/_includes/navigation/sidebar-left.html +17 -16
data/_includes/navigation/sidebar-right.html +8 -7
data/_includes/obsidian/full-graph.html +2 -2
data/_includes/setup/claude-session.html +72 -0
data/_includes/setup/prereq-checklist.html +90 -0
data/_includes/setup/wizard.html +924 -222
data/_includes/stats/stats-categories.html +8 -8
data/_includes/stats/stats-header.html +14 -14
data/_includes/stats/stats-metrics.html +14 -14
data/_includes/stats/stats-no-data.html +12 -12
data/_includes/stats/stats-overview.html +6 -6
data/_includes/stats/stats-tags.html +8 -8
data/_layouts/404.html +38 -24
data/_layouts/README.md +2 -0
data/_layouts/admin.html +24 -24
data/_layouts/article.html +43 -33
data/_layouts/author.html +20 -20
data/_layouts/authors.html +2 -2
data/_layouts/book-abc.html +12 -12
data/_layouts/book-story.html +15 -15
data/_layouts/book.html +12 -12
data/_layouts/collection.html +33 -33
data/_layouts/cookbook.html +88 -0
data/_layouts/default.html +31 -28
data/_layouts/home.html +23 -23
data/_layouts/index.html +10 -10
data/_layouts/landing.html +17 -17
data/_layouts/news.html +44 -44
data/_layouts/note.html +38 -38
data/_layouts/notebook.html +34 -34
data/_layouts/recipe.html +274 -0
data/_layouts/root.html +92 -55
data/_layouts/section.html +62 -33
data/_layouts/setup.html +3 -3
data/_layouts/sitemap-collection.html +49 -49
data/_layouts/stats.html +40 -40
data/_layouts/tag.html +12 -12
data/_layouts/welcome.html +21 -21
data/_sass/components/_callout.scss +1 -1
data/_sass/components/_footer.scss +37 -1
data/_sass/components/_mermaid.scss +375 -0
data/_sass/components/_page-views.scss +36 -0
data/_sass/components/_recipe.scss +506 -0
data/_sass/components/_setup-wizard.scss +764 -0
data/_sass/components/_ui-enhancements.scss +6 -6
data/_sass/core/_navbar.scss +261 -46
data/_sass/layouts/_landing.scss +2 -2
data/_sass/layouts/_navbar-extras.scss +14 -4
data/_sass/tokens/_color.scss +6 -0
data/_sass/tokens/_index.scss +2 -0
data/_sass/tokens/_radius.scss +21 -0
data/_sass/tokens/_typography.scss +4 -0
data/_sass/utilities/_focus.scss +14 -0
data/assets/css/main.scss +4 -0
data/assets/js/ai-chat.js +47 -5
data/assets/js/fleet-feedback-capture.js +124 -0
data/assets/js/fleet-feedback.js +853 -0
data/assets/js/mermaid-diagrams.js +1267 -0
data/assets/js/modules/navigation/config.js +9 -6
data/assets/js/modules/navigation/navbar.js +55 -0
data/assets/js/modules/navigation/scroll-spy.js +315 -80
data/assets/js/modules/theme/appearance.js +8 -2
data/assets/js/obsidian-wiki-links.js +8 -3
data/assets/js/page-feedback.js +125 -192
data/assets/js/page-views.js +372 -0
data/assets/js/recipe-scaler.js +501 -0
data/assets/js/search-modal.js +36 -0
data/assets/js/setup-wizard.js +2279 -226
data/assets/js/site-builder.js +1834 -0
data/assets/js/ui-enhancements.js +11 -3
data/scripts/README.md +44 -0
data/scripts/ai/README.md +38 -0
data/scripts/ai/api_call.rb +124 -0
data/scripts/ai/usage.rb +314 -0
data/scripts/ai/usage_report.rb +225 -0
data/scripts/bin/audit-consumer +39 -7
data/scripts/bin/giscus-discussions +213 -14
data/scripts/bin/manifest +35 -12
data/scripts/ci/agent_review_result.py +164 -0
data/scripts/ci/test_agent_review_result.py +172 -0
data/scripts/ci/test_visual_evidence_autogen.py +341 -0
data/scripts/ci/visual_evidence_autogen.py +1060 -0
data/scripts/content-review.rb +20 -1
data/scripts/design-system-check.rb +170 -0
data/scripts/lib/audit.sh +42 -2
data/scripts/lint-liquid-raw.rb +137 -0
data/scripts/test/integration/mermaid +22 -8
data/scripts/test/lib/run_tests.sh +3 -1
data/scripts/test/lib/test_agent_review_result.sh +27 -0
data/scripts/test/lib/test_visual_evidence_autogen.sh +24 -0
data/scripts/translate.rb +94 -16
metadata +48 -2

data/_includes/core/console-capture.html CHANGED Viewed

@@ -1,89 +1,47 @@
 {%- comment -%}
   ===================================================================
-  CONSOLE CAPTURE — early, tiny console/error ring buffer
+  CONSOLE CAPTURE — early console/error ring buffer
   ===================================================================
   File:    console-capture.html
   Path:    _includes/core/console-capture.html
-  Purpose: Capture a capped, in-memory buffer of console output and
-           uncaught errors, installed HIGH in <head> — before the
-           theme's deferred scripts run — so the page-feedback widget
-           (assets/js/page-feedback.js) can attach the logs and JS
-           errors that led up to a report.
+  Purpose: Load the fleet feedback kit's capture buffer HIGH in <head> —
+           before the theme's deferred scripts run — so the page-feedback
+           widget can attach the logs and JS errors that led up to a report.
   Renders: only when page_feedback.enabled AND page_feedback.capture_logs.
+  This used to be ~60 lines of inline ES5 maintained here. It is now the
+  fleet kit's capture.js, VENDORED to assets/js/fleet-feedback-capture.js
+  (bamr87/bamr87 templates/feedback/capture.js — drift check (i) holds the
+  copy to the hub's). Two things came with the move: the buffer shape is
+  now the one FleetFeedbackCore reads, so the theme's widget and the fleet's
+  web component file byte-identical issues; and every captured line is
+  REDACTED before it enters the ring (bearer/API keys, JWTs, GitHub tokens,
+  email addresses), so a secret cannot be previewed, copied, or filed.
+  Loaded blocking rather than deferred, and that is the point: a buffer
+  installed after parsing misses exactly the load-time failures worth
+  reporting. It is ~4 KB, and it REPLACED ~3.7 KB of inline script, so the
+  head got smaller — which also buys back room for the charset meta that
+  has to land in the first 1024 bytes (issue #372).
   Privacy: in-memory only, never persisted, never sent anywhere until the
-           user opens the feedback modal, reviews the captured logs, and
-           chooses to submit. Any single entry is truncated; the buffer is
-           a fixed-size ring (page_feedback.log_limit).
+           reader opens the modal, reviews the captured lines, and submits.
+           Any single entry is truncated; the buffer is a fixed-size ring
+           (page_feedback.log_limit, default 40).
-  Depends on: nothing — pure inline ES5, GitHub Pages-safe (no CDN).
+  Depends on: assets/js/fleet-feedback-capture.js (vendored, no CDN).
   ===================================================================
 {%- endcomment -%}
 {%- if site.page_feedback.enabled and site.page_feedback.capture_logs -%}
-<script>
-/* page-feedback: early console/error capture — see _includes/core/console-capture.html */
-(function () {
-  "use strict";
-  if (window.__zer0Feedback && window.__zer0Feedback.installed) { return; }
-  var LIMIT = {{ site.page_feedback.log_limit | default: 40 | jsonify }};
-  var MAX_ENTRY = 600;      // truncate any single entry so the buffer stays small
-  var start = (window.performance && performance.now) ? null : Date.now();
-  var buffer = [];
-  function now() { return start === null ? Math.round(performance.now()) : (Date.now() - start); }
-  function stringify(value) {
-    if (typeof value === "string") { return value; }
-    if (value instanceof Error) {
-      return (value.name || "Error") + ": " + (value.message || "") + (value.stack ? "\n" + value.stack : "");
-    }
-    try { return JSON.stringify(value); } catch (e) { return String(value); }
-  }
-  function push(level, args) {
-    try {
-      var parts = [];
-      for (var i = 0; i < args.length; i++) { parts.push(stringify(args[i])); }
-      var text = parts.join(" ");
-      if (text.length > MAX_ENTRY) { text = text.slice(0, MAX_ENTRY) + "…"; }
-      buffer.push({ t: now(), level: level, text: text });
-      while (buffer.length > LIMIT) { buffer.shift(); }
-    } catch (e) { /* logging must never break the page */ }
-  }
-  // Wrap console methods, preserving passthrough to the real console.
-  if (window.console) {
-    ["log", "info", "warn", "error", "debug"].forEach(function (level) {
-      var original = console[level] ? console[level].bind(console) : null;
-      console[level] = function () {
-        push(level, arguments);
-        if (original) { original.apply(null, arguments); }
-      };
-    });
-  }
-  // Uncaught errors and unhandled promise rejections.
-  window.addEventListener("error", function (e) {
-    if (!e) { return; }
-    var where = e.filename ? " (" + e.filename + ":" + (e.lineno || 0) + ":" + (e.colno || 0) + ")" : "";
-    push("error", [(e.message || "Script error") + where]);
-  });
-  window.addEventListener("unhandledrejection", function (e) {
-    var reason = e && e.reason;
-    var msg = reason && reason.message ? reason.message : stringify(reason);
-    push("error", ["Unhandled promise rejection: " + msg]);
-  });
-  window.__zer0Feedback = {
-    installed: true,
-    logs: buffer,
-    /** Snapshot the buffer (newest last) for the widget to read. */
-    snapshot: function () { return buffer.slice(); },
-    clear: function () { buffer.length = 0; }
-  };
-})();
-</script>
+<script src="{{ '/assets/js/fleet-feedback-capture.js' | relative_url }}"></script>
+{%- comment -%}
+  The ring size is site configuration, so it is applied after the buffer
+  installs rather than baked into the vendored file (which must stay
+  byte-identical to the hub's).
+{%- endcomment -%}
+{%- if site.page_feedback.log_limit -%}
+<script>if(window.__fleetFeedback){window.__fleetFeedback.limit={{ site.page_feedback.log_limit | jsonify }};}</script>
+{%- endif -%}
 {%- endif -%}

data/_includes/core/favicon.html CHANGED Viewed

@@ -16,12 +16,17 @@
                  png_size    : 32x32                           # sizes attr for png (optional)
                  apple_touch : /assets/images/apple-touch.png  # iOS home-screen icon (optional)
                  manifest    : /site.webmanifest               # PWA manifest (optional)
-                 theme_color : "#0d1117"                       # browser chrome color (optional)
+                 theme_color       : "#0d1117"                 # pin ONE chrome color (optional)
+                 theme_color_light : "#ffffff"                 # light-scheme chrome (optional)
+                 theme_color_dark  : "#212529"                 # dark-scheme chrome (optional)
                With NO config at all this still emits the explicit
-               /favicon.ico link (every consumer site carries one at root),
-               and theme_color falls back to site.theme_color.main so the
-               mobile address bar matches the site's design tokens.
+               /favicon.ico link (every consumer site carries one at root)
+               AND both theme-color tags. That last part is the point of the
+               fallbacks below: a remote_theme consumer does not inherit this
+               repo's _config.yml (see remote-theme-checklist.md), so a
+               config-gated tag emitted nothing at all on exactly the sites
+               this include exists to serve (issue #281).
   Notes:       Page-invariant — safe to render via include_cached. All paths
                run through relative_url so baseurl deployments resolve.
 {%- endcomment -%}
@@ -40,7 +45,44 @@
 {%- if _fav.manifest %}
 <link rel="manifest" href="{{ _fav.manifest | relative_url }}">
 {%- endif %}
-{%- assign _fav_theme_color = _fav.theme_color | default: site.theme_color.main -%}
-{%- if _fav_theme_color %}
-<meta name="theme-color" content="{{ _fav_theme_color }}">
+{%- comment -%}
+  theme-color drives mobile browser chrome (iOS Safari address/status bar,
+  the Chrome/Android task-switcher card). It must track the page SURFACE.
+  It used to fall back to site.theme_color.main, which is the brand ACCENT --
+  #007bff on this site -- so a dark-first theme advertised a bright blue
+  address bar. The defaults below are Bootstrap 5.3.3's own --bs-body-bg for
+  each scheme (:root #fff, [data-bs-theme=dark] #212529); the theme adds no
+  dark override of that variable, so they are the real computed surface.
+  WHICH SHAPE TO EMIT depends on how the mode is decided, because
+  `media="(prefers-color-scheme: ...)"` keys off the OS and nothing else:
+    - mode is pinned (color_mode_lock, or a non-auto color_mode_default)
+      -> ONE unconditional tag. A media pair would hand light chrome to an
+         OS-light visitor looking at a page this site renders dark.
+    - mode is `auto` -> the media pair, which is exactly what `auto` means.
+  A locked `auto` resolves to dark here, matching core/color-mode-init.html.
+  Known limitation, deliberately not solved here: an unlocked site lets a
+  visitor override the mode from the Appearance panel via localStorage, which
+  no static meta can follow. Keeping chrome in sync with the panel needs a
+  runtime hook in the toggle path -- tracked separately.
+{%- endcomment -%}
+{%- assign _tc_light = _fav.theme_color_light | default: '#ffffff' -%}
+{%- assign _tc_dark  = _fav.theme_color_dark  | default: '#212529' -%}
+{%- assign _tc_mode  = site.color_mode_default | default: 'auto' -%}
+{%- if _fav.theme_color %}
+{%- comment -%} Back-compat: a consumer that pinned one colour keeps it. {%- endcomment %}
+<meta name="theme-color" content="{{ _fav.theme_color }}">
+{%- elsif site.color_mode_lock and _tc_mode == 'light' %}
+<meta name="theme-color" content="{{ _tc_light }}">
+{%- elsif site.color_mode_lock or _tc_mode == 'dark' %}
+<meta name="theme-color" content="{{ _tc_dark }}">
+{%- elsif _tc_mode == 'light' %}
+<meta name="theme-color" content="{{ _tc_light }}">
+{%- else %}
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="{{ _tc_light }}">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="{{ _tc_dark }}">
 {%- endif %}

data/_includes/core/footer-fabs.html CHANGED Viewed

@@ -20,12 +20,26 @@
   after </footer> is visually identical to the previous nesting.
   ===================================================================
 {%- endcomment -%}
-{%- assign _root_only_layouts = "landing,welcome,stats,sitemap-collection,setup,section,news,index,home,admin" | split: "," -%}
-{%- unless _root_only_layouts contains page.layout -%}
+{%- comment -%}
+  The TOC FAB controls `#tocContents`, which navigation/sidebar-right.html
+  emits — and only _layouts/default.html includes that. This used to be a
+  DENYLIST of layouts to skip, which fails open: any layout not on the list got
+  the FAB whether or not it rendered the panel, and the list had already fallen
+  behind (404 and the book-* layouts were missing, so those pages shipped a FAB
+  pointing at nothing — issue #373).
+  Replaced with the positive gate from navigation/sidebar-config.html, which
+  fails safe: a new layout gets no FAB until it is declared as one that renders
+  the offcanvas. sidebar-config is included here rather than relied upon from
+  header.html because Liquid assigns propagate to the INCLUDING template, and
+  these are two sibling includes of root.html.
+{%- endcomment -%}
+{% include navigation/sidebar-config.html %}
+{%- if sidebar_offcanvas_rendered -%}
   {% include navigation/toc-fab.html %}
   {%- comment -%} Local-graph FAB/panel are part of the Obsidian feature. {%- endcomment -%}
   {%- if site.obsidian.enabled != false -%}
     {% include navigation/local-graph-fab.html %}
     {% include navigation/local-graph.html %}
   {%- endif -%}
-{%- endunless -%}
+{%- endif -%}

data/_includes/core/footer.html CHANGED Viewed

@@ -1,5 +1,5 @@
 {% comment %} Feature: ZER0-046 {% endcomment %}
-<!--
+{% comment %}
   ===================================================================
   FOOTER - Comprehensive Site Footer with Branding & Navigation
   ===================================================================
@@ -33,12 +33,12 @@
   - Guard optional fields (address/phone/email) to avoid empty output
   - Use relative_url for internal links to respect baseurl
   ===================================================================
--->
+{% endcomment %}
 {%- include core/i18n.html lang=include.lang -%}
 <footer class="bd-footer border-top" role="contentinfo">
   {% assign footer_page_urls = site.html_pages | map: "url" | join: "|" | prepend: "|" | append: "|" %}
-  <!-- Powered by Row -->
+  {% comment %} Powered by Row {% endcomment %}
   <div class="container-xl footer-powered-by">
     <p class="footer-powered-by-copyright text-center mb-0">
       &copy; {{ site.time | date: "%Y" }} {{ site.name | default: site.title }}
@@ -76,15 +76,16 @@
             </span>
           {% endif %}
           {% if forloop.last and powered_by_count > 0 %}
-                <a href="#"
-                   class="powered-by-link"
-                   data-bs-toggle="offcanvas"
-                   data-bs-target="#info-section"
-                   aria-label="View theme information and system details"
-                   title="Theme Info">
+                <button type="button"
+                        class="powered-by-link"
+                        data-bs-toggle="offcanvas"
+                        data-bs-target="#info-section"
+                        aria-haspopup="dialog"
+                        aria-label="View theme information and system details"
+                        title="Theme Info">
                   <i class="{{ site.default_icon }} bi-info-circle" aria-hidden="true"></i>
                   <span class="powered-by-link-text">Info</span>
-                </a>
+                </button>
               </span>
             </li>
           {% else %}
@@ -93,27 +94,28 @@
         {% endfor %}
         {% if powered_by_count == 0 %}
           <li>
-            <a href="#"
-               class="powered-by-link"
-               data-bs-toggle="offcanvas"
-               data-bs-target="#info-section"
-               aria-label="View theme information and system details"
-               title="Theme Info">
+            <button type="button"
+                    class="powered-by-link"
+                    data-bs-toggle="offcanvas"
+                    data-bs-target="#info-section"
+                    aria-haspopup="dialog"
+                    aria-label="View theme information and system details"
+                    title="Theme Info">
               <i class="{{ site.default_icon }} bi-info-circle" aria-hidden="true"></i>
               <span class="powered-by-link-text">Info</span>
-            </a>
+            </button>
           </li>
         {% endif %}
       </ul>
     </div>
   </div>
-  <!-- Branding and Navigation Block — full-width dark background -->
+  {% comment %} Branding and Navigation Block — full-width dark background {% endcomment %}
   <div class="bg-dark text-light footer-dark-block">
     <div class="container-xl">
-        <!-- Top: Site info + Quick Links + Social -->
+        {% comment %} Top: Site info + Quick Links + Social {% endcomment %}
         <div class="row mb-3 mb-lg-4 g-2 g-lg-3 footer-nav-columns justify-content-center">
-          <!-- Site Info -->
+          {% comment %} Site Info {% endcomment %}
           <div class="col-12 col-md-3 col-lg-3 mb-2 mb-lg-3 order-0 order-md-1 order-lg-1">
             <h2 class="footer-section-title text-uppercase h6 mb-0">{{ site.title }}</h2>
             {% if site.address %}<p class="mb-1">{{ site.address }}</p>{% endif %}
@@ -121,12 +123,12 @@
             {% if site.email %}<p class="mb-0"><a href="mailto:{{ site.email }}" class="text-light text-decoration-none">{{ site.email }}</a></p>{% endif %}
           </div>
-          <!-- Quick Links
+          {% comment %} Quick Links
                Resolution order:
                  1. site.footer_quick_links  (array of {label, url}) — explicit override
                  2. Auto-detection: only render links whose target pages
                     actually exist in the build. Prevents 404s on bare-minimum
-                    sites that haven't created /about/, /services/, etc. -->
+                    sites that haven't created /about/, /services/, etc. {% endcomment %}
           <div class="col-6 col-md-3 col-lg-3 mb-2 mb-lg-3 order-2 order-md-2 order-lg-2">
             <h2 class="footer-section-title text-uppercase h6 mb-0">Quick Links</h2>
             <ul class="list-unstyled" aria-label="Footer quick links">
@@ -169,7 +171,7 @@
             </ul>
           </div>
-          <!-- Latest Posts (dynamic) -->
+          {% comment %} Latest Posts (dynamic) {% endcomment %}
           {% assign posts_count = site.posts | size %}
           {% if posts_count and posts_count > 0 %}
           <div class="col-12 col-md-3 col-lg-3 mb-2 mb-lg-3 order-4 order-md-3 order-lg-3">
@@ -184,7 +186,7 @@
           </div>
           {% endif %}
-          <!-- Social & RSS -->
+          {% comment %} Social & RSS {% endcomment %}
           <div class="col-6 col-md-3 col-lg-3 mb-2 mb-lg-3 order-3 order-md-4 order-lg-4">
             <h2 class="footer-section-title text-uppercase h6 mb-0">Follow Us</h2>
             <ul class="list-inline mb-0" aria-label="Social links">
@@ -192,7 +194,17 @@
                 {% if link.url %}
                   <li class="list-inline-item">
                     {% capture link_icon_classes %}{{ site.default_icon }} {{ link.icon | default: "bi-link-45deg" }}{% endcapture %}
-                    <a href="{{ link.url }}" rel="nofollow" class="text-light text-decoration-none">
+                    {%- comment -%}
+                      aria-label is load-bearing below the md breakpoint (issue
+                      #435): the icon is aria-hidden and the label span is
+                      d-none there, so without it the link had NO accessible
+                      name at all on mobile — a screen reader announced bare
+                      "link". It matches the visible text exactly, so the
+                      accessible name still contains the visible label at md+
+                      (WCAG 2.5.3 Label in Name).
+                    {%- endcomment -%}
+                    <a href="{{ link.url }}" rel="nofollow" class="text-light text-decoration-none"
+                       aria-label="{{ link.label }}">
                       <i class="{{ link_icon_classes }}" aria-hidden="true"></i>
                       <span class="d-none d-md-inline">{{ link.label }}</span>
                     </a>
@@ -200,16 +212,19 @@
                 {% endif %}
               {% endfor %}
               <li class="list-inline-item">
-                <a class="text-light text-decoration-none" href="{{ '/feed.xml' | relative_url }}">
+                {%- comment -%} Same as the social links above (#435). {%- endcomment -%}
+                {%- assign _feed_label = ui.feed_label | default: "Feed" -%}
+                <a class="text-light text-decoration-none" href="{{ '/feed.xml' | relative_url }}"
+                   aria-label="{{ _feed_label }}">
                   <i class="{{ site.default_icon }} bi-rss" aria-hidden="true"></i>
-                  <span class="d-none d-md-inline">{{ ui.feed_label | default: "Feed" }}</span>
+                  <span class="d-none d-md-inline">{{ _feed_label }}</span>
                 </a>
               </li>
             </ul>
           </div>
         </div>
-        <!-- Middle: Subscribe + Policies -->
+        {% comment %} Middle: Subscribe + Policies {% endcomment %}
         <div class="row mb-3 mb-lg-4 align-items-center justify-content-center g-2 footer-subscribe-row">
           <div class="col-12 col-md-8 col-lg-8">
             <form class="row g-2 footer-subscribe-form" aria-label="Newsletter signup" onsubmit="return false;">
@@ -239,15 +254,15 @@
                 <li class="list-inline-item"><a href="{{ site.terms_of_service_url | default: '/terms-of-service' | relative_url }}" class="text-light text-decoration-none">Terms of Service</a></li>
               {% endif %}
               <li class="list-inline-item">
-                <a href="#" class="text-light text-decoration-none" data-bs-toggle="modal" data-bs-target="#cookieSettingsModal">
+                <button type="button" class="footer-inline-button text-light text-decoration-none" data-bs-toggle="modal" data-bs-target="#cookieSettingsModal">
                   Cookie Preferences
-                </a>
+                </button>
               </li>
             </ul>
           </div>
         </div>
-      <!-- Bottom: Copyright -->
+      {% comment %} Bottom: Copyright {% endcomment %}
       <div class="text-center">
         <p class="mb-0">&copy; {{ site.time | date: "%Y" }} {{ site.title | default: site.name }}. All Rights Reserved.</p>
       </div>
@@ -263,9 +278,9 @@
     immediately after </footer> is visually identical to nesting them inside.
   {%- endcomment -%}
-  <!-- Back to Top Button (controlled by assets/js/back-to-top.js) -->
-  <!-- Positioning/stacking handled by _sass/components/_back-to-top.scss
-       via the FAB tokens (bottom-up: back-to-top → chat toggle → TOC FAB) -->
+  {% comment %} Back to Top Button (controlled by assets/js/back-to-top.js) {% endcomment %}
+  {% comment %} Positioning/stacking handled by _sass/components/_back-to-top.scss
+       via the FAB tokens (bottom-up: back-to-top → chat toggle → TOC FAB) {% endcomment %}
   <a
     id="backToTopBtn"
     href="#"