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

jekyll-theme-zer0 1.29.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 (148) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +715 -2
data/_data/README.md +2 -0
data/_data/ai.yml +5 -3
data/_data/ai_pricing.yml +36 -0
data/_data/backlog.yml +169 -18
data/_data/consumers.yml +48 -5
data/_data/features.yml +146 -20
data/_data/feedback_types.yml +17 -12
data/_data/landing.yml +5 -2
data/_data/navigation/quickstart.yml +4 -0
data/_data/site_builder.yml +874 -0
data/_data/theme-manifest.yml +122 -114
data/_data/ui-text.yml +18 -0
data/_includes/README.md +11 -1
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 +8 -8
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 +11 -11
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 +36 -36
data/_includes/components/js-cdn.html +15 -15
data/_includes/components/language-toggle.html +4 -4
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 +1 -1
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/search-modal.html +27 -2
data/_includes/components/searchbar.html +2 -2
data/_includes/components/svg-background.html +2 -2
data/_includes/components/theme-customizer.html +2 -2
data/_includes/components/theme-info.html +6 -6
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 +2 -2
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 +31 -18
data/_includes/core/head.html +102 -90
data/_includes/core/header.html +71 -52
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 +16 -16
data/_includes/navigation/sidebar-config.html +36 -2
data/_includes/navigation/sidebar-left.html +15 -15
data/_includes/navigation/sidebar-right.html +6 -6
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 +906 -291
data/_includes/stats/stats-categories.html +8 -8
data/_includes/stats/stats-header.html +14 -14
data/_includes/stats/stats-metrics.html +12 -12
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/admin.html +22 -22
data/_layouts/article.html +39 -34
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 +12 -12
data/_layouts/default.html +27 -24
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 +24 -24
data/_layouts/root.html +73 -55
data/_layouts/section.html +23 -23
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/_mermaid.scss +375 -0
data/_sass/components/_setup-wizard.scss +569 -40
data/_sass/core/_navbar.scss +11 -31
data/_sass/layouts/_navbar-extras.scss +14 -4
data/assets/css/main.scss +1 -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/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/search-modal.js +26 -0
data/assets/js/setup-wizard.js +2112 -361
data/assets/js/site-builder.js +1834 -0
data/assets/js/ui-enhancements.js +11 -3
data/scripts/README.md +15 -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/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/test/integration/mermaid +22 -8
data/scripts/test/lib/run_tests.sh +1 -0
data/scripts/test/lib/test_visual_evidence_autogen.sh +24 -0
data/scripts/translate.rb +23 -1
metadata +19 -2

data/_includes/components/page-feedback.html CHANGED Viewed

@@ -61,24 +61,34 @@
 {%- assign pf_theme = site.theme | default: site.remote_theme | default: "" -%}
 {%- if pf_show_fab -%}
-<!-- Global feedback FAB (page-invariant; opens the modal) -->
-<button type="button"
-        id="pageFeedbackFab"
-        class="pf-fab btn shadow-lg position-fixed"
-        data-pf-open
-        aria-haspopup="dialog"
-        aria-controls="pageFeedbackModal"
-        title="{{ site.page_feedback.fab_label | default: 'Improve this page' | escape }}"
-        aria-label="{{ site.page_feedback.fab_label | default: 'Improve this page' | escape }}">
+{% comment %} Global feedback FAB (page-invariant; opens the modal) {% endcomment %}
+{%- comment -%}
+  An anchor, not a button, and the href is load-bearing: the widget now
+  delegates issue assembly to assets/js/fleet-feedback.js, so if that script
+  fails to load (or JavaScript is off entirely) the FAB still reaches the
+  issue form instead of becoming a decorative circle. page-feedback.js
+  intercepts [data-pf-open] and opens the richer modal when it is running.
+{%- endcomment -%}
+<a id="pageFeedbackFab"
+   class="pf-fab btn shadow-lg position-fixed"
+   href="https://github.com/{{ pf_repo }}/issues/new?template=page_improvement.yml&labels=page-feedback"
+   role="button"
+   data-pf-open
+   target="_blank"
+   rel="noopener noreferrer"
+   aria-haspopup="dialog"
+   aria-controls="pageFeedbackModal"
+   title="{{ site.page_feedback.fab_label | default: 'Improve this page' | escape }}"
+   aria-label="{{ site.page_feedback.fab_label | default: 'Improve this page' | escape }}">
   <i class="bi {{ site.page_feedback.fab_icon | default: 'bi-megaphone' }}" aria-hidden="true"></i>
-</button>
+</a>
 {%- endif -%}
-<!-- Feedback modal (self-contained overlay; controlled by page-feedback.js).
+{% comment %} Feedback modal (self-contained overlay; controlled by page-feedback.js).
      `position-fixed` is required, not cosmetic: it opts this <body> child out of
      the .zer0-bg-body flattening rule (_sass/theme/_backgrounds.scss) that would
      otherwise force position:relative; z-index:1 and let the cookie banner steal
-     the dialog's clicks. -->
+     the dialog's clicks. {% endcomment %}
 <div class="pf-overlay position-fixed" id="pageFeedbackModal" role="dialog" aria-modal="true"
      aria-labelledby="pfTitle" aria-describedby="pfIntro" hidden>
   <div class="pf-dialog shadow-lg" role="document">
@@ -100,16 +110,18 @@
     <form id="pfForm" class="pf-body" novalidate>
-      <!-- Step 1 — request type -->
+      {% comment %} Step 1 — request type {% endcomment %}
       <fieldset class="pf-field pf-types">
         <legend class="pf-legend">What kind of feedback?</legend>
         {%- comment -%}
           _data/feedback_types.yml is optional for consumers (remote_theme
           cannot ship _data). Without it the widget falls back to a minimal
           generic taxonomy (see pf_fallback_types below) instead of rendering
-          an empty selector. The fallback entries carry no GitHub labels and
-          no agent directive — labels must exist in the target repo or GitHub
-          silently drops them from prefilled issue URLs.
+          an empty selector. The fallback carries the four fleet-taxonomy
+          labels (bug/docs/feature/question) and no agent directive: a label
+          the consumer repo does not have is silently dropped by GitHub, so
+          naming them costs nothing and makes the issue pipeline-eligible the
+          moment the feedback fan-out creates them.
         {%- endcomment -%}
         {%- assign pf_group = "" -%}
         {%- for t in site.data.feedback_types -%}
@@ -138,8 +150,7 @@
             cannot ship _data). Without it, render this minimal generic
             taxonomy instead of an empty selector. Ids/markup must stay in
             sync with the fallback JSON in the #pageFeedbackTypes script
-            below. Fallback entries carry no GitHub labels (labels must exist
-            in the target repo or GitHub silently drops them) and no agent
+            below, which carries the fleet-taxonomy labels and no agent
             directive.
           {%- endcomment -%}
           <p class="pf-types-group">This page</p>
@@ -183,7 +194,7 @@
         {%- endfor -%}
       </fieldset>
-      <!-- Step 2 — description -->
+      {% comment %} Step 2 — description {% endcomment %}
       <div class="pf-field">
         <label for="pfDescription" class="pf-label">Describe it</label>
         <textarea id="pfDescription" class="form-control" rows="4"
@@ -194,14 +205,14 @@
         </p>
       </div>
-      <!-- Step 3 — what gets attached -->
+      {% comment %} Step 3 — what gets attached {% endcomment %}
       <details class="pf-field pf-context" id="pfContextWrap">
         <summary class="pf-summary">
           <i class="bi bi-paperclip me-1" aria-hidden="true"></i>What gets attached
           <span class="pf-context-count" id="pfContextCount"></span>
         </summary>
         <ul class="pf-context-list" id="pfContextList" aria-live="polite">
-          <!-- page title / url / path filled in by JS -->
+          {% comment %} page title / url / path filled in by JS {% endcomment %}
         </ul>
         {%- if site.page_feedback.capture_logs -%}
@@ -221,7 +232,7 @@
       </details>
       {%- if pf_ai_available -%}
-      <!-- Step 4 — optional AI review (proxy + Claude Code OAuth) -->
+      {% comment %} Step 4 — optional AI review (proxy + Claude Code OAuth) {% endcomment %}
       <div class="pf-field pf-ai" id="pfAiWrap">
         <div class="pf-ai-head">
           <button type="button" class="btn btn-sm btn-outline-primary" id="pfAnalyze">
@@ -253,7 +264,7 @@
   </div>
 </div>
-<!-- Widget configuration consumed by assets/js/page-feedback.js -->
+{% comment %} Widget configuration consumed by assets/js/page-feedback.js {% endcomment %}
 <script id="pageFeedbackConfig" type="application/json">
 {
   "enabled": true,
@@ -275,19 +286,19 @@
 }
 </script>
-<!-- Request-type taxonomy (from _data/feedback_types.yml; generic fallback
+{% comment %} Request-type taxonomy (from _data/feedback_types.yml; generic fallback
      when the site ships no data file — keep in sync with the fallback markup
-     in the pf-types fieldset above) -->
+     in the pf-types fieldset above) {% endcomment %}
 <script id="pageFeedbackTypes" type="application/json">
 {% if site.data.feedback_types %}{{ site.data.feedback_types | jsonify }}{% else %}[
-  {"id":"fix-page","label":"Report a problem","icon":"bi-bug","group":"This page","scope":"page","description":"A typo, broken link, wrong information, or something rendering badly","labels":[],"agent":false,"placeholder":"What is wrong, where on the page, and what did you expect instead?"},
-  {"id":"improve-page","label":"Improve this page","icon":"bi-stars","group":"This page","scope":"page","description":"Polish the copy, structure, or presentation","labels":[],"agent":false,"placeholder":"What would make this page clearer, tighter, or more useful?"},
-  {"id":"feature","label":"Suggest a feature","icon":"bi-lightbulb","group":"The site","scope":"site","description":"An idea that would make the site more useful","labels":[],"agent":false,"placeholder":"Describe the feature and the problem it would solve."},
-  {"id":"question","label":"Ask a question","icon":"bi-question-circle","group":"The site","scope":"site","description":"Something unclear that is not exactly a bug","labels":[],"agent":false,"placeholder":"What would you like to know?"}
+  {"id":"fix-page","label":"Report a problem","icon":"bi-bug","group":"This page","scope":"page","description":"A typo, broken link, wrong information, or something rendering badly","labels":["bug"],"agent":false,"placeholder":"What is wrong, where on the page, and what did you expect instead?"},
+  {"id":"improve-page","label":"Improve this page","icon":"bi-stars","group":"This page","scope":"page","description":"Polish the copy, structure, or presentation","labels":["docs"],"agent":false,"placeholder":"What would make this page clearer, tighter, or more useful?"},
+  {"id":"feature","label":"Suggest a feature","icon":"bi-lightbulb","group":"The site","scope":"site","description":"An idea that would make the site more useful","labels":["feature"],"agent":false,"placeholder":"Describe the feature and the problem it would solve."},
+  {"id":"question","label":"Ask a question","icon":"bi-question-circle","group":"The site","scope":"site","description":"Something unclear that is not exactly a bug","labels":["question"],"agent":false,"placeholder":"What would you like to know?"}
 ]{% endif %}
 </script>
-<!-- Live page context (build-time front matter; runtime detail added by JS) -->
+{% comment %} Live page context (build-time front matter; runtime detail added by JS) {% endcomment %}
 <script id="pageFeedbackContext" type="application/json">
 {
   "title": {{ page.title | default: site.title | jsonify }},
@@ -310,6 +321,10 @@
 }
 </script>
+{% comment %} The shared fleet builder must be parsed before the widget: page-feedback.js
+     reads window.FleetFeedbackCore at load and bails without it. Both are `defer`, and
+     deferred scripts execute in document order, so this ordering is the dependency. {% endcomment %}
+<script defer src="{{ '/assets/js/fleet-feedback.js' | relative_url }}"></script>
 <script defer src="{{ '/assets/js/page-feedback.js' | relative_url }}"></script>
 {%- endunless -%}

data/_includes/components/page-views-init.html CHANGED Viewed

@@ -31,7 +31,7 @@
 {%- assign pv_fallback = false -%}
 {%- if site.page_views.fallback_local -%}{%- assign pv_fallback = true -%}{%- endif -%}
-<!-- Page-view counter configuration consumed by assets/js/page-views.js -->
+{% comment %} Page-view counter configuration consumed by assets/js/page-views.js {% endcomment %}
 <script id="pageViewsConfig" type="application/json">
 {
   "enabled": true,

data/_includes/components/post-card.html CHANGED Viewed

@@ -1,4 +1,4 @@
-<!--
+{% comment %}
   ===================================================================
   POST CARD COMPONENT - Reusable blog post card
   ===================================================================
@@ -41,7 +41,7 @@
   - site.public_folder for image paths
   - site.teaser for fallback image
   ===================================================================
--->
+{% endcomment %}
 {% comment %} Parameter defaults {% endcomment %}
 {% assign show_category = include.show_category | default: true %}
@@ -70,44 +70,44 @@
 {% if render_col %}<div class="col">{% endif %}
   <div class="card h-100 post-card border-0 shadow-sm {{ card_class }}">
-    <!-- ====================== -->
-    <!-- CARD IMAGE & BADGES    -->
-    <!-- ====================== -->
+    {% comment %} ====================== {% endcomment %}
+    {% comment %} CARD IMAGE & BADGES    {% endcomment %}
+    {% comment %} ====================== {% endcomment %}
     <div class="position-relative">
-      <!-- Breaking News Badge -->
+      {% comment %} Breaking News Badge {% endcomment %}
       {% if include.post.breaking %}
         <span class="badge bg-danger position-absolute top-0 start-0 m-2 z-1">
           <i class="bi bi-lightning-fill me-1"></i>Breaking
         </span>
       {% endif %}
-      <!-- Featured Badge -->
+      {% comment %} Featured Badge {% endcomment %}
       {% if include.post.featured %}
         <span class="badge bg-warning text-dark position-absolute top-0 end-0 m-2 z-1">
           <i class="bi bi-star-fill me-1"></i>Featured
         </span>
       {% endif %}
-      <!-- Post Type Badge -->
+      {% comment %} Post Type Badge {% endcomment %}
       {% if show_post_type and include.post.post_type and include.post.post_type != "standard" and include.post.post_type != "featured" and include.post.post_type != "breaking" %}
         <span class="position-absolute bottom-0 start-0 m-2 z-1">
           {% include components/post-type-badge.html post_type=include.post.post_type %}
         </span>
       {% endif %}
-      <!-- Preview Image -->
+      {% comment %} Preview Image {% endcomment %}
       <a href="{{ include.post.url | relative_url }}" class="text-decoration-none">
         {% assign card_img = include.post.preview | default: site.teaser %}
         {% include components/preview-image.html src=card_img alt=include.post.title class="card-img-top" %}
       </a>
     </div>
-    <!-- ====================== -->
-    <!-- CARD BODY              -->
-    <!-- ====================== -->
+    {% comment %} ====================== {% endcomment %}
+    {% comment %} CARD BODY              {% endcomment %}
+    {% comment %} ====================== {% endcomment %}
     <div class="card-body d-flex flex-column">
-      <!-- Category Badge -->
+      {% comment %} Category Badge {% endcomment %}
       {% comment %} Category base is configurable (`category_base`, default `/news`).
          Only link the badge when that category index page exists in the build;
          otherwise render a plain badge so remote-theme consumers (whose category
@@ -135,7 +135,7 @@
         </div>
       {% endif %}
-      <!-- Post Title -->
+      {% comment %} Post Title {% endcomment %}
       <h5 class="card-title mb-2">
         <a href="{{ include.post.url | relative_url }}"
            class="text-decoration-none text-body-emphasis stretched-link">
@@ -143,14 +143,14 @@
         </a>
       </h5>
-      <!-- Subtitle if available -->
+      {% comment %} Subtitle if available {% endcomment %}
       {% if include.post.sub-title %}
         <p class="card-subtitle text-muted small mb-2">
           {{ include.post.sub-title }}
         </p>
       {% endif %}
-      <!-- Post Excerpt -->
+      {% comment %} Post Excerpt {% endcomment %}
       {% if show_excerpt %}
         <p class="card-text text-muted small flex-grow-1">
           {{ include.post.excerpt | strip_html | truncate: 120 }}
@@ -159,13 +159,13 @@
     </div>
-    <!-- ====================== -->
-    <!-- CARD FOOTER            -->
-    <!-- ====================== -->
+    {% comment %} ====================== {% endcomment %}
+    {% comment %} CARD FOOTER            {% endcomment %}
+    {% comment %} ====================== {% endcomment %}
     <div class="card-footer bg-transparent border-top-0">
       <div class="d-flex justify-content-between align-items-center small text-muted">
-        <!-- Left: Author & Date -->
+        {% comment %} Left: Author & Date {% endcomment %}
         <div>
           {% if show_author and include.post.author %}
             <span class="me-2">
@@ -177,7 +177,7 @@
           </span>
         </div>
-        <!-- Right: Reading Time -->
+        {% comment %} Right: Reading Time {% endcomment %}
         {% if show_reading_time %}
           <span>
             <i class="bi bi-clock me-1"></i>{{ reading_time }}
@@ -186,7 +186,7 @@
       </div>
-      <!-- Tags (compact) -->
+      {% comment %} Tags (compact) {% endcomment %}
       {% if include.post.tags.size > 0 %}
         <div class="mt-2">
           {% for tag in include.post.tags limit: 3 %}

data/_includes/components/post-type-badge.html CHANGED Viewed

@@ -1,5 +1,5 @@
 {% comment %} Feature: ZER0-064 {% endcomment %}
-<!--
+{% comment %}
   ===================================================================
   POST TYPE BADGE COMPONENT - Visual indicator for article types
   ===================================================================
@@ -29,7 +29,7 @@
   - Bootstrap 5 badge component
   - Bootstrap Icons
   ===================================================================
--->
+{% endcomment %}
 {% assign type = include.post_type | default: "standard" %}

data/_includes/components/powered-by.html CHANGED Viewed

@@ -1,8 +1,8 @@
-<!--
+{% comment %}
   file: powered-by.html
   path:_includes/powered-by.html
   description: This file is used to display the powered by section on the home page.
- -->
+ {% endcomment %}
 <div class="row row-cols-1 row-cols-md-3 g-4">
   {% for power in site.powered_by %}

data/_includes/components/preview-image.html CHANGED Viewed

@@ -10,6 +10,12 @@
        style="height: 180px; object-fit: cover;"
     -%}
+  WHICH INCLUDE: this one renders an <img> in the content flow. For cover art
+  painted as a CSS background on an otherwise empty box, use the sibling
+  components/background-image.html -- a background image is invisible to
+  assistive tech, so that case needs role="img" + aria-label (or aria-hidden
+  when purely decorative) rather than an alt attribute.
   Convention: Preview paths can omit the /assets/ prefix.
   The component will auto-prepend the assets_prefix from _config.yml.
   Examples:

data/_includes/components/quick-index.html CHANGED Viewed

@@ -1,4 +1,4 @@
-<!-- Quick index of pages in the collection -->
+{% comment %} Quick index of pages in the collection {% endcomment %}
 {% if site.collections.pages %}
 <ul>
   <p>Quick Index</p>
@@ -10,7 +10,7 @@
 </ul>
 {% endif %}
-<!-- Post Categories -->
+{% comment %} Post Categories {% endcomment %}
 {% if page.sidebar == "searchCats" %}
 <div id="categories">
 </div>

data/_includes/components/search-modal.html CHANGED Viewed

@@ -1,5 +1,5 @@
 {% comment %} Feature: ZER0-032 {% endcomment %}
-<!--
+{% comment %}
   ===================================================================
   SEARCH MODAL - Site-wide Search Popup
   ===================================================================
@@ -16,7 +16,7 @@
     prevents a dead link on remote-theme Pages builds that lack /sitemap/.
   - Keyboard shortcut handled by navigation keyboard module ("/")
   ===================================================================
--->
+{% endcomment %}
 {%- include core/i18n.html lang=include.lang -%}
 {%- assign search_placeholder = ui.search_placeholder_text | default: "Enter your search term..." -%}
@@ -72,6 +72,31 @@
                         Press <kbd>/</kbd> or <kbd>⌘</kbd>/<kbd>Ctrl</kbd>+<kbd>K</kbd> to open search, <kbd>Esc</kbd> to close.
                     </div>
                 </form>
+                {%- comment -%}
+                  Results were never announced (issue #279): search rewrites the
+                  container below without moving focus, so a screen-reader user
+                  got silence — the visible list changed with nothing entering
+                  the accessibility tree's notification queue.
+                  The live region is this dedicated, visually-hidden element
+                  rather than the results container itself. Marking the
+                  container live would announce all eight result titles and
+                  their snippets on every keystroke, which is unusable; a
+                  screen-reader user wants "7 results for jekyll", then to
+                  navigate the list on their own terms.
+                  polite, not assertive: results land on each keystroke and an
+                  assertive region would interrupt the user mid-word, cutting
+                  off the query they are still typing.
+                  aria-atomic so the summary is read as one message even when
+                  only part of the string changes (8 results -> 7 results).
+                {%- endcomment -%}
+                <div class="visually-hidden"
+                     role="status"
+                     aria-live="polite"
+                     aria-atomic="true"
+                     data-search-status></div>
                 <div class="search-results mt-3" data-search-results>
                     <div class="text-muted small" data-search-empty>Start typing to see results.</div>
                 </div>

data/_includes/components/searchbar.html CHANGED Viewed

@@ -1,9 +1,9 @@
 {% comment %} Feature: ZER0-032 {% endcomment %}
-<!--
+{% comment %}
   title: Searchbar and hits
   source: Theme component
--->
+{% endcomment %}
 <div class="container order-1">
     <div id="searchbox" class=""   ></div>
     <div id="hits" class="text-start"></div>

data/_includes/components/svg-background.html CHANGED Viewed

@@ -1,4 +1,4 @@
-<!--
+{% comment %}
   ===================================================================
   SVG-BACKGROUND — Apply fffuel-style SVG background to a zone
   ===================================================================
@@ -20,7 +20,7 @@
     - _data/theme_backgrounds.yml    (asset paths)
     - _config.yml theme_background   (opacity / blend settings)
   ===================================================================
--->
+{% endcomment %}
 {% assign zone = include.zone | default: "body" %}
 {% assign skin = site.theme_skin | default: "dark" %}

data/_includes/components/theme-customizer.html CHANGED Viewed

@@ -1,4 +1,4 @@
-<!--
+{% comment %}
   ===================================================================
   THEME CUSTOMIZER — Skin preview grid with live class swapping
   ===================================================================
@@ -12,7 +12,7 @@
   Dependencies: Bootstrap 5 grid/card, Bootstrap Icons
   Used by: pages/_about/settings/theme.md (Skin Preview tab)
   ===================================================================
--->
+{% endcomment %}
 {%- comment -%}
   _data/theme_skins.yml is optional for consumers (remote_theme cannot ship

data/_includes/components/theme-info.html CHANGED Viewed

@@ -1,5 +1,5 @@
 {% comment %} Feature: ZER0-021 {% endcomment %}
-<!--
+{% comment %}
   ===================================================================
   THEME INFO - Compact Theme and Build Information
   ===================================================================
@@ -15,12 +15,12 @@
   Note: environment (Prod/Dev) is shown by env-switcher.html in the
   same Site tab — not duplicated here.
   ===================================================================
--->
+{% endcomment %}
 <div class="theme-info-compact">
   <div class="row g-2">
-    <!-- Theme -->
+    {% comment %} Theme {% endcomment %}
     <div class="col-12">
       <div class="d-flex align-items-center justify-content-between p-2 bg-body-tertiary rounded">
         <div class="d-flex align-items-center">
@@ -44,7 +44,7 @@
       </div>
     </div>
-    <!-- Jekyll & Last Build -->
+    {% comment %} Jekyll & Last Build {% endcomment %}
     <div class="col-6">
       <div class="p-2 bg-body-tertiary rounded text-center">
         <small class="text-body-secondary d-block">Jekyll</small>
@@ -66,7 +66,7 @@
     </div>
     {% if site.repository %}
-    <!-- Repository -->
+    {% comment %} Repository {% endcomment %}
     <div class="col-12">
       <div class="d-flex align-items-center justify-content-between p-2 bg-body-tertiary rounded">
         <div class="d-flex align-items-center">
@@ -81,7 +81,7 @@
     </div>
     {% endif %}
-    <!-- Quick Links -->
+    {% comment %} Quick Links {% endcomment %}
     <div class="col-12 mt-2">
       <div class="d-flex flex-wrap gap-2 justify-content-center">
         {% if site.remote_theme %}