jekyll-theme-zer0 1.29.0 → 1.31.0

data/_includes/components/theme-preview-gallery.html

@@ -1,8 +1,8 @@
 {% comment %} Feature: ZER0-065 {% endcomment %}
-<!--
+{% comment %}
   Theme Preview — component gallery for live skin / mode testing.
   Pair with theme-controls-bar.html and theme-customizer.js.
--->
+{% endcomment %}
 <div class="theme-preview-gallery" id="theme-preview-gallery">
 
   <p class="text-body-secondary">
@@ -11,7 +11,7 @@
     <code>theme_color</code> may take precedence over skin tokens for <code>--zer0-color-*</code> variables.
   </p>
 
-  <!-- Typography -->
+  {% comment %} Typography {% endcomment %}
   <section class="theme-preview-section" id="preview-typography" aria-labelledby="preview-typography-heading">
     <h2 class="h4 theme-preview-heading" id="preview-typography-heading">
       <i class="bi bi-fonts me-2" aria-hidden="true"></i>Typography
@@ -33,7 +33,7 @@
     </div>
   </section>
 
-  <!-- Buttons -->
+  {% comment %} Buttons {% endcomment %}
   <section class="theme-preview-section" id="preview-buttons" aria-labelledby="preview-buttons-heading">
     <h2 class="h4 theme-preview-heading" id="preview-buttons-heading">
       <i class="bi bi-hand-index-thumb me-2" aria-hidden="true"></i>Buttons
@@ -59,7 +59,7 @@
     </div>
   </section>
 
-  <!-- Alerts -->
+  {% comment %} Alerts {% endcomment %}
   <section class="theme-preview-section" id="preview-alerts" aria-labelledby="preview-alerts-heading">
     <h2 class="h4 theme-preview-heading" id="preview-alerts-heading">
       <i class="bi bi-exclamation-triangle me-2" aria-hidden="true"></i>Alerts
@@ -72,7 +72,7 @@
     <div class="alert alert-info" role="alert">Info alert</div>
   </section>
 
-  <!-- Cards -->
+  {% comment %} Cards {% endcomment %}
   <section class="theme-preview-section" id="preview-cards" aria-labelledby="preview-cards-heading">
     <h2 class="h4 theme-preview-heading" id="preview-cards-heading">
       <i class="bi bi-card-heading me-2" aria-hidden="true"></i>Cards
@@ -100,7 +100,7 @@
     </div>
   </section>
 
-  <!-- Forms -->
+  {% comment %} Forms {% endcomment %}
   <section class="theme-preview-section" id="preview-forms" aria-labelledby="preview-forms-heading">
     <h2 class="h4 theme-preview-heading" id="preview-forms-heading">
       <i class="bi bi-input-cursor-text me-2" aria-hidden="true"></i>Forms
@@ -134,7 +134,7 @@
     </div>
   </section>
 
-  <!-- Nav tabs -->
+  {% comment %} Nav tabs {% endcomment %}
   <section class="theme-preview-section" id="preview-tabs" aria-labelledby="preview-tabs-heading">
     <h2 class="h4 theme-preview-heading" id="preview-tabs-heading">
       <i class="bi bi-layout-text-window-reverse me-2" aria-hidden="true"></i>Nav tabs
@@ -152,7 +152,7 @@
     </ul>
   </section>
 
-  <!-- Badges -->
+  {% comment %} Badges {% endcomment %}
   <section class="theme-preview-section" id="preview-badges" aria-labelledby="preview-badges-heading">
     <h2 class="h4 theme-preview-heading" id="preview-badges-heading">
       <i class="bi bi-award me-2" aria-hidden="true"></i>Badges
@@ -168,7 +168,7 @@
     </p>
   </section>
 
-  <!-- Code blocks -->
+  {% comment %} Code blocks {% endcomment %}
   <section class="theme-preview-section" id="preview-code" aria-labelledby="preview-code-heading">
     <h2 class="h4 theme-preview-heading" id="preview-code-heading">
       <i class="bi bi-code-slash me-2" aria-hidden="true"></i>Code blocks
@@ -214,7 +214,7 @@ docker-compose up
 {% endhighlight %}
   </section>
 
-  <!-- Links -->
+  {% comment %} Links {% endcomment %}
   <section class="theme-preview-section" id="preview-links" aria-labelledby="preview-links-heading">
     <h2 class="h4 theme-preview-heading" id="preview-links-heading">
       <i class="bi bi-link-45deg me-2" aria-hidden="true"></i>Links
@@ -226,7 +226,7 @@ docker-compose up
     </p>
   </section>
 
-  <!-- Navbar snippet -->
+  {% comment %} Navbar snippet {% endcomment %}
   <section class="theme-preview-section" id="preview-navbar" aria-labelledby="preview-navbar-heading">
     <h2 class="h4 theme-preview-heading" id="preview-navbar-heading">
       <i class="bi bi-layout-navbar me-2" aria-hidden="true"></i>Navbar snippet
@@ -244,7 +244,7 @@ docker-compose up
     </nav>
   </section>
 
-  <!-- Footer snippet -->
+  {% comment %} Footer snippet {% endcomment %}
   <section class="theme-preview-section" id="preview-footer" aria-labelledby="preview-footer-heading">
     <h2 class="h4 theme-preview-heading" id="preview-footer-heading">
       <i class="bi bi-layout-text-sidebar-reverse me-2" aria-hidden="true"></i>Footer snippet
@@ -269,7 +269,7 @@ docker-compose up
     </footer>
   </section>
 
-  <!-- Table -->
+  {% comment %} Table {% endcomment %}
   <section class="theme-preview-section" id="preview-table" aria-labelledby="preview-table-heading">
     <h2 class="h4 theme-preview-heading" id="preview-table-heading">
       <i class="bi bi-table me-2" aria-hidden="true"></i>Table
@@ -288,7 +288,7 @@ docker-compose up
     </div>
   </section>
 
-  <!-- List group -->
+  {% comment %} List group {% endcomment %}
   <section class="theme-preview-section" id="preview-list-group" aria-labelledby="preview-list-group-heading">
     <h2 class="h4 theme-preview-heading" id="preview-list-group-heading">
       <i class="bi bi-list-ul me-2" aria-hidden="true"></i>List group
@@ -300,7 +300,7 @@ docker-compose up
     </ul>
   </section>
 
-  <!-- Backgrounds -->
+  {% comment %} Backgrounds {% endcomment %}
   <section class="theme-preview-section" id="preview-backgrounds" aria-labelledby="preview-backgrounds-heading">
     <h2 class="h4 theme-preview-heading" id="preview-backgrounds-heading">
       <i class="bi bi-image me-2" aria-hidden="true"></i>Background layers
@@ -324,7 +324,7 @@ docker-compose up
     </div>
   </section>
 
-  <!-- Callouts -->
+  {% comment %} Callouts {% endcomment %}
   <section class="theme-preview-section" id="preview-callouts" aria-labelledby="preview-callouts-heading">
     <h2 class="h4 theme-preview-heading" id="preview-callouts-heading">
       <i class="bi bi-chat-square-text me-2" aria-hidden="true"></i>Callouts
@@ -341,7 +341,7 @@ docker-compose up
     {% include components/callout.html type="danger"  title="Danger"  content=_danger_body %}
   </section>
 
-  <!-- Accordion -->
+  {% comment %} Accordion {% endcomment %}
   <section class="theme-preview-section" id="preview-accordion" aria-labelledby="preview-accordion-heading">
     <h2 class="h4 theme-preview-heading" id="preview-accordion-heading">
       <i class="bi bi-chevron-bar-expand me-2" aria-hidden="true"></i>Accordion
@@ -382,7 +382,7 @@ docker-compose up
     </div>
   </section>
 
-  <!-- Progress & Spinners -->
+  {% comment %} Progress & Spinners {% endcomment %}
   <section class="theme-preview-section" id="preview-progress" aria-labelledby="preview-progress-heading">
     <h2 class="h4 theme-preview-heading" id="preview-progress-heading">
       <i class="bi bi-hourglass-split me-2" aria-hidden="true"></i>Progress &amp; Spinners
@@ -434,7 +434,7 @@ docker-compose up
     </div>
   </section>
 
-  <!-- Breadcrumb & Pagination -->
+  {% comment %} Breadcrumb & Pagination {% endcomment %}
   <section class="theme-preview-section" id="preview-breadcrumb" aria-labelledby="preview-breadcrumb-heading">
     <h2 class="h4 theme-preview-heading" id="preview-breadcrumb-heading">
       <i class="bi bi-signpost-split me-2" aria-hidden="true"></i>Breadcrumb &amp; Pagination
@@ -479,7 +479,7 @@ docker-compose up
     </div>
   </section>
 
-  <!-- Tooltips & Popovers -->
+  {% comment %} Tooltips & Popovers {% endcomment %}
   <section class="theme-preview-section" id="preview-tooltips" aria-labelledby="preview-tooltips-heading">
     <h2 class="h4 theme-preview-heading" id="preview-tooltips-heading">
       <i class="bi bi-chat-dots me-2" aria-hidden="true"></i>Tooltips &amp; Popovers
@@ -503,7 +503,7 @@ docker-compose up
     </div>
   </section>
 
-  <!-- Icons showcase -->
+  {% comment %} Icons showcase {% endcomment %}
   <section class="theme-preview-section" id="preview-icons" aria-labelledby="preview-icons-heading">
     <h2 class="h4 theme-preview-heading" id="preview-icons-heading">
       <i class="bi bi-grid me-2" aria-hidden="true"></i>Bootstrap Icons
@@ -519,7 +519,7 @@ docker-compose up
           <i class="bi bi-person-circle"    title="bi-person-circle"></i>
           <i class="bi bi-palette"          title="bi-palette"></i>
           <i class="bi bi-code-slash"       title="bi-code-slash"></i>
-          <i class="bi bi-file-earmark-text"title="bi-file-earmark-text"></i>
+          <i class="bi bi-file-earmark-text" title="bi-file-earmark-text"></i>
           <i class="bi bi-check-circle text-success" title="success"></i>
           <i class="bi bi-x-circle     text-danger"  title="danger"></i>
           <i class="bi bi-exclamation-triangle text-warning" title="warning"></i>

data/_includes/content/giscus.html

@@ -1,5 +1,5 @@
 {% comment %} Feature: ZER0-035 {% endcomment %}
-<!--
+{% comment %}
   giscus.html — GitHub Discussions comment system
   ===============================================
 
@@ -30,7 +30,7 @@
   NOTE: do not write a bare `include giscus.html` example with live Liquid
   braces inside this file — Liquid evaluates tags even inside HTML comments,
   which would recursively (and wrongly) try to include "giscus.html".
--->
+{% endcomment %}
 
 <script src="https://giscus.app/client.js"
         data-repo="{{ site.repository }}"

data/_includes/content/intro.html

@@ -1,4 +1,4 @@
-<!--
+{% comment %}
   file: _includes/content/intro.html
   description: Enhanced intro section with share, edit, and improve/report buttons
   path: _includes/content/intro.html
@@ -12,14 +12,14 @@
     - Responsive flex layout: full-width content block, frosted metadata footer with reading time and action buttons
     - Balanced padding and typography hierarchy via bd-intro-* classes
     - Metadata row: author, dates, category, difficulty, tags, view source
--->
+{% endcomment %}
 {%- include core/i18n.html -%}
 {% if page.collection %}
   {% capture page_dir %}{{ site.collections_dir }}{% endcapture %}
   {% assign testvar = "collection exists" %}
 {% endif %}
 
-<!-- Intro Section -->
+{% comment %} Intro Section {% endcomment %}
 
 {% comment %}
   Determine the preview image path. Preview paths can omit the /assets/ prefix.
@@ -29,6 +29,13 @@
 {% assign assets_prefix = site.preview_images.assets_prefix | default: '/assets' %}
 {% assign auto_prefix = site.preview_images.auto_prefix | default: true %}
 
+{% comment %} Leading-slash normalisation, as in components/preview-image.html:
+   `preview: images/x.png` used to resolve to /assetsimages/x.png. {% endcomment %}
+{% unless preview_image == nil or preview_image == "" or preview_image contains '://' or preview_image contains 'data:' %}
+  {% assign preview_first = preview_image | slice: 0 %}
+  {% if preview_first != '/' %}{% assign preview_image = '/' | append: preview_image %}{% endif %}
+{% endunless %}
+
 {% if preview_image contains '://' %}
   {% assign preview_path = preview_image %}
 {% elsif auto_prefix and preview_image != blank %}
@@ -228,9 +235,9 @@
           {% endif %}
         </p>
 
-        <!-- Action Buttons Group -->
+        {% comment %} Action Buttons Group {% endcomment %}
         <div class="bd-intro-actions">
-    <!-- Share Button -->
+    {% comment %} Share Button {% endcomment %}
     <div class="dropdown">
       <button class="btn btn-sm btn-info dropdown-toggle" type="button" id="shareDropdownBottom" data-bs-toggle="dropdown" aria-expanded="false">
         <i class="bi bi-share" aria-hidden="true"></i>
@@ -273,10 +280,10 @@
       </ul>
     </div>
 
-    <!-- Improve / Report — opens the page-feedback widget (assets/js/page-feedback.js).
+    {% comment %} Improve / Report — opens the page-feedback widget (assets/js/page-feedback.js).
          Progressive enhancement: this is a real link to the issue form, so it
          works without JavaScript; page-feedback.js intercepts [data-pf-open]
-         clicks and opens the richer capture modal (context + logs + AI) instead. -->
+         clicks and opens the richer capture modal (context + logs + AI) instead. {% endcomment %}
     {% if site.page_feedback.enabled %}
     <a class="btn btn-sm btn-success bd-intro-action-link"
        href="https://github.com/{{ site.repository }}/issues/new?template=page_improvement.yml&labels=page-feedback"
@@ -289,7 +296,7 @@
     </a>
     {% endif %}
 
-    <!-- Edit on GitHub Button -->
+    {% comment %} Edit on GitHub Button {% endcomment %}
     <a href="https://github.com/{{ site.repository }}/blob/{{ repo_branch }}/{{ file_path }}"
        class="btn btn-sm btn-dark bd-intro-action-link"
        target="_blank"

data/_includes/content/jsonld-faq.html

@@ -1,5 +1,5 @@
 {% comment %} Feature: ZER0-054 {% endcomment %}
-<!--
+{% comment %}
   ===================================================================
   JSON-LD FAQ SCHEMA - FAQPage Structured Data
   ===================================================================
@@ -24,7 +24,7 @@
   Dependencies:
   - Page front matter with faq_items array
   ===================================================================
--->
+{% endcomment %}
 
 {% if page.faq_items and page.faq_items.size > 0 %}
 <script type="application/ld+json">

data/_includes/content/jsonld-software.html

@@ -1,4 +1,4 @@
-<!--
+{% comment %}
   ===================================================================
   JSON-LD STRUCTURED DATA - SoftwareApplication + WebPage Schema
   ===================================================================
@@ -37,7 +37,7 @@
   - Included automatically in _includes/core/head.html
   - Conditional: opted in AND page.permalink == "/"
   ===================================================================
--->
+{% endcomment %}
 
 {%- assign _is_homepage = false -%}
 {%- if page.permalink == "/" or page.url == "/" -%}

data/_includes/content/seo.html

@@ -1,5 +1,5 @@
 {% comment %} Features: ZER0-041, ZER0-054 {% endcomment %}
-<!--
+{% comment %}
   ===================================================================
   SEO SUPPLEMENT - Additional meta tags not covered by jekyll-seo-tag
   ===================================================================
@@ -22,7 +22,7 @@
   - jekyll-seo-tag plugin (loaded in _layouts/root.html via seo tags)
   - site.preview_images config in _config.yml
   ===================================================================
--->
+{% endcomment %}
 
 {%- comment -%}
   Custom og:image handling: supports page.preview and page.header.og_image
@@ -43,6 +43,14 @@
     nil seo_image — og:image was silently dropped on every page without a
     page.header image, defeating the site.og_image fallback entirely.
   {%- endcomment -%}
+  {%- comment -%} Leading-slash normalisation, as in components/preview-image.html:
+    `preview: images/x.png` used to become og:image …/assetsimages/x.png. {%- endcomment -%}
+  {%- if page_teaser_image and page_teaser_image != "" -%}
+    {%- unless page_teaser_image contains '://' or page_teaser_image contains 'data:' -%}
+      {%- assign teaser_first = page_teaser_image | slice: 0 -%}
+      {%- if teaser_first != '/' -%}{%- assign page_teaser_image = '/' | append: page_teaser_image -%}{%- endif -%}
+    {%- endunless -%}
+  {%- endif -%}
   {%- if page_teaser_image contains '://' -%}
     {%- comment -%} External URL - use as-is {%- endcomment -%}
   {%- elsif auto_prefix and page_teaser_image and page_teaser_image != blank -%}
@@ -63,7 +71,7 @@
   {%- endif -%}
 {%- endunless -%}
 
-<!-- Site verification (non-Google; Google is handled by jekyll-seo-tag) -->
+{% comment %} Site verification (non-Google; Google is handled by jekyll-seo-tag) {% endcomment %}
 {% if site.bing_site_verification %}
   <meta name="msvalidate.01" content="{{ site.bing_site_verification }}">
 {% endif %}
@@ -79,4 +87,4 @@
 {% if site.baidu_site_verification %}
   <meta name="baidu-site-verification" content="{{ site.baidu_site_verification }}">
 {% endif %}
-<!-- end _includes/content/seo.html -->
+{% comment %} end _includes/content/seo.html {% endcomment %}