jekyll-theme-zer0 1.29.0 → 1.31.0

data/_layouts/collection.html

@@ -2,7 +2,7 @@
 # Feature: ZER0-019
 layout: default
 ---
-<!--
+{% comment %}
   ===================================================================
   COLLECTION LAYOUT - Display template for Jekyll collections
   ===================================================================
@@ -42,18 +42,18 @@ layout: default
   - Bootstrap 5 card and grid components
   - Site configuration for public_folder and teaser image
   ===================================================================
--->
+{% endcomment %}
 
-<!-- ========================== -->
-<!-- COLLECTION PAGE CONTENT    -->
-<!-- ========================== -->
-<!-- Main content area for collection description or introduction -->
+{% comment %} ========================== {% endcomment %}
+{% comment %} COLLECTION PAGE CONTENT    {% endcomment %}
+{% comment %} ========================== {% endcomment %}
+{% comment %} Main content area for collection description or introduction {% endcomment %}
 {{ content }}
 
-<!-- ========================== -->
-<!-- COLLECTION DATA PROCESSING -->
-<!-- ========================== -->
-<!-- Extract and sort collection entries based on page configuration.
+{% comment %} ========================== {% endcomment %}
+{% comment %} COLLECTION DATA PROCESSING {% endcomment %}
+{% comment %} ========================== {% endcomment %}
+{% comment %} Extract and sort collection entries based on page configuration.
 
      Jekyll sets page.collection automatically for a document inside a
      collection, but a standalone page can also select this layout in its front
@@ -61,12 +61,12 @@ layout: default
      declare — site[page.collection] is nil, and `sort` on nil raises
      "Cannot sort a null object.", which aborts the ENTIRE build rather than
      just this page. Resolve to an empty list instead so one misconfigured page
-     cannot take the site down. -->
+     cannot take the site down. {% endcomment %}
 {% assign entries = site[page.collection] %}
 {% if entries %}
     {% assign entries = entries | sort: page.sort_order %}
 
-    <!-- Handle reverse sorting if specified -->
+    {% comment %} Handle reverse sorting if specified {% endcomment %}
     {% if page.sort_order == 'reverse' %}
         {% assign entries = entries | reverse %}
     {% endif %}
@@ -74,53 +74,53 @@ layout: default
     {% assign entries = "" | split: "" %}
 {% endif %}
 
-<!-- ========================== -->
-<!-- COLLECTION INDEX HEADER    -->
-<!-- ========================== -->
+{% comment %} ========================== {% endcomment %}
+{% comment %} COLLECTION INDEX HEADER    {% endcomment %}
+{% comment %} ========================== {% endcomment %}
 <h2 id="index-collection">
     Collection Index - {{ page.collection }}
 </h2>
 
-<!-- ================================ -->
-<!-- COLLECTION ITEMS GRID           -->
-<!-- ================================ -->
-<!-- Responsive card grid: 1 column mobile, up to 3 columns desktop -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} COLLECTION ITEMS GRID           {% endcomment %}
+{% comment %} ================================ {% endcomment %}
+{% comment %} Responsive card grid: 1 column mobile, up to 3 columns desktop {% endcomment %}
 <div class="row row-cols-1 row-cols-md-3 g-4">
     
     {% for post in entries %}
         <div class="col">
-            <!-- Bootstrap card with equal height for consistent layout -->
+            {% comment %} Bootstrap card with equal height for consistent layout {% endcomment %}
             <div class="card h-100">
                 
-                <!-- ====================== -->
-                <!-- CARD IMAGE SECTION     -->
-                <!-- ====================== -->
-                <!-- Display preview image with fallback to site teaser -->
+                {% comment %} ====================== {% endcomment %}
+                {% comment %} CARD IMAGE SECTION     {% endcomment %}
+                {% comment %} ====================== {% endcomment %}
+                {% comment %} Display preview image with fallback to site teaser {% endcomment %}
                 {% assign coll_img = post.preview | default: site.teaser %}
                 {% include components/preview-image.html src=coll_img alt=post.title class="card-img-top" %}
                 
-                <!-- ====================== -->
-                <!-- CARD CONTENT SECTION   -->
-                <!-- ====================== -->
+                {% comment %} ====================== {% endcomment %}
+                {% comment %} CARD CONTENT SECTION   {% endcomment %}
+                {% comment %} ====================== {% endcomment %}
                 <div class="card-body">
-                    <!-- Post title with SEO microdata -->
+                    {% comment %} Post title with SEO microdata {% endcomment %}
                     <h5 class="card-title" itemprop="headline">
                         <a class="card-link" href="{{ post.url | relative_url }}" rel="permalink">
                             {{ post.title }}
                         </a>
                     </h5>
                     
-                    <!-- Post excerpt with HTML stripped and character limit -->
+                    {% comment %} Post excerpt with HTML stripped and character limit {% endcomment %}
                     <p class="card-text" itemprop="description">
                         {{ post.excerpt | strip_html | truncate: 160 }}
                     </p>
                 </div>
                 
-                <!-- ====================== -->
-                <!-- CARD FOOTER SECTION    -->
-                <!-- ====================== -->
+                {% comment %} ====================== {% endcomment %}
+                {% comment %} CARD FOOTER SECTION    {% endcomment %}
+                {% comment %} ====================== {% endcomment %}
                 <div class="card-footer">
-                    <!-- Last modified date for content freshness indicator -->
+                    {% comment %} Last modified date for content freshness indicator {% endcomment %}
                     <small class="text-body-secondary post-meta">
                         Last updated {{ post.lastmod | date: '%B %d, %Y' }}
                     </small>

data/_layouts/cookbook.html

@@ -25,9 +25,9 @@ layout: default
 {%- assign _cb_image = page.image | default: page.preview -%}
 
 <div class="cookbook">
-  <!-- ================================ -->
-  <!-- COVER                            -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} COVER                            {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <header class="cookbook-header">
     <div class="row g-4 align-items-center">
       {%- if _cb_image -%}
@@ -56,9 +56,9 @@ layout: default
     </div>
   </header>
 
-  <!-- ================================ -->
-  <!-- ABOUT (the markdown body)        -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} ABOUT (the markdown body)        {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {%- assign _cb_body = content | strip -%}
   {%- if _cb_body != "" -%}
   <section class="cookbook-about">
@@ -66,9 +66,9 @@ layout: default
   </section>
   {%- endif -%}
 
-  <!-- ================================ -->
-  <!-- COURSE JUMP NAV                  -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} COURSE JUMP NAV                  {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {%- if _cb_courses.size > 1 and page.grouped != false -%}
   <nav class="cookbook-jump" aria-label="Jump to a course">
     {%- for _cb_pair in site.data.recipe_courses -%}
@@ -81,8 +81,8 @@ layout: default
   </nav>
   {%- endif -%}
 
-  <!-- ================================ -->
-  <!-- RECIPE INDEX                     -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} RECIPE INDEX                     {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {%- include components/recipe-index.html cookbook=_cb_slug grouped=page.grouped heading_level="h2" -%}
 </div>

data/_layouts/default.html

@@ -2,7 +2,7 @@
 # Features: ZER0-001, ZER0-008, ZER0-019
 layout: root
 ---
-<!--
+{% comment %}
   ===================================================================
   DEFAULT LAYOUT - Standard content layout with sidebars
   ===================================================================
@@ -43,7 +43,7 @@ layout: root
   - bd-toc: Table of contents styling
   - bd-content: Content area styling
   ===================================================================
--->
+{% endcomment %}
 
 {%- comment -%}
   Sidebar visibility + nav mode are resolved by the shared include below
@@ -58,16 +58,16 @@ layout: root
 {%- endcomment -%}
 {% include navigation/sidebar-config.html %}
 
-<!-- ================================================ -->
-<!-- MAIN LAYOUT CONTAINER                           -->
-<!-- Bootstrap responsive container with custom grid -->
-<!-- ================================================ -->
+{% comment %} ================================================ {% endcomment %}
+{% comment %} MAIN LAYOUT CONTAINER                           {% endcomment %}
+{% comment %} Bootstrap responsive container with custom grid {% endcomment %}
+{% comment %} ================================================ {% endcomment %}
 <div class="container-xxl bd-gutter mt-3 my-md-4 bd-layout{% unless sidebar_has_content %} bd-layout--no-sidebar{% endunless %}">
 
-    <!-- ================================ -->
-    <!-- LEFT SIDEBAR - Navigation       -->
-    <!-- ================================ -->
-    <!-- Site navigation, content outline, and offcanvas menu for mobile -->
+    {% comment %} ================================ {% endcomment %}
+    {% comment %} LEFT SIDEBAR - Navigation       {% endcomment %}
+    {% comment %} ================================ {% endcomment %}
+    {% comment %} Site navigation, content outline, and offcanvas menu for mobile {% endcomment %}
     {% if sidebar_has_content %}
     <aside class="bd-sidebar">
         {% include navigation/sidebar-left.html %}
@@ -83,13 +83,16 @@ layout: root
     </div>
     {% endif %}
 
-    <!-- ================================ -->
-    <!-- MAIN CONTENT AREA               -->
-    <!-- ================================ -->
-    <!-- Primary content section with scroll spy for table of contents navigation.
+    {% comment %} ================================ {% endcomment %}
+    {% comment %} MAIN CONTENT AREA               {% endcomment %}
+    {% comment %} ================================ {% endcomment %}
+    {% comment %} Primary content section. TOC highlighting is handled by the
+         theme's own scroll spy (assets/js/modules/navigation/scroll-spy.js) —
+         no `data-bs-spy` here, because Bootstrap's native ScrollSpy fought it
+         for the `.active` class and made the bolding jump around.
          Not a <main>: root.html already provides the single <main id="main-content">
-         landmark; a nested <main> here would duplicate it (issue #299). -->
-    <div class="bd-main order-1" data-bs-spy="scroll" data-bs-target="#TableOfContents" data-bs-offset="100" data-bs-smooth-scroll="true">
+         landmark; a nested <main> here would duplicate it (issue #299). {% endcomment %}
+    <div class="bd-main order-1">
 
         {%- comment -%}
           Page introduction: title, breadcrumbs, metadata.
@@ -105,20 +108,20 @@ layout: root
           {% include content/intro.html %}
         {% endunless %}
 
-        <!-- =============================== -->
-        <!-- RIGHT SIDEBAR - Table of Contents -->
-        <!-- =============================== -->
-        <!-- Page outline, shortcuts, and related links (hidden on mobile) -->
+        {% comment %} =============================== {% endcomment %}
+        {% comment %} RIGHT SIDEBAR - Table of Contents {% endcomment %}
+        {% comment %} =============================== {% endcomment %}
+        {% comment %} Page outline, shortcuts, and related links (hidden on mobile) {% endcomment %}
         {% unless sidebar_enabled == false %}
         <div class="bd-toc text-body-secondary">
             {% include navigation/sidebar-right.html %}
         </div>
         {% endunless %}
 
-        <!-- =============================== -->
-        <!-- MAIN CONTENT BODY              -->
-        <!-- =============================== -->
-        <!-- Where the actual page content is rendered -->
+        {% comment %} =============================== {% endcomment %}
+        {% comment %} MAIN CONTENT BODY              {% endcomment %}
+        {% comment %} =============================== {% endcomment %}
+        {% comment %} Where the actual page content is rendered {% endcomment %}
         <div class="bd-content ps-lg-2">
             {{ content }}
 

data/_layouts/home.html

@@ -2,7 +2,7 @@
 # Feature: ZER0-019
 layout: root
 ---
-<!--
+{% comment %}
   ===================================================================
   HOME LAYOUT - Homepage template with minimal structure
   ===================================================================
@@ -45,36 +45,48 @@ layout: root
   - RSS link maintains blog connectivity
   - Clean presentation suitable for landing pages
   ===================================================================
--->
+{% endcomment %}
 
-<!-- ================================ -->
-<!-- HOME PAGE CONTAINER             -->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} HOME PAGE CONTAINER             {% endcomment %}
+{% comment %} ================================ {% endcomment %}
 <div class="home">
-    <!-- ========================== -->
-    <!-- OPTIONAL PAGE TITLE        -->
-    <!-- ========================== -->
-    <!-- Display title only if specified in page frontmatter. -->
-    <!-- Usage: Add 'title: "Homepage Title"' to page frontmatter. -->
-    <!-- Landing/showcase pages can keep `title` for SEO but suppress the -->
-    <!-- visible heading (e.g. when a custom hero supplies its own <h1>) -->
-    <!-- with `hide_title: true`. -->
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} OPTIONAL PAGE TITLE        {% endcomment %}
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} Display title only if specified in page frontmatter. {% endcomment %}
+    {% comment %} Usage: Add 'title: "Homepage Title"' to page frontmatter. {% endcomment %}
+    {% comment %} Landing/showcase pages can keep `title` for SEO but suppress the {% endcomment %}
+    {% comment %} visible heading (e.g. when a custom hero supplies its own <h1>) {% endcomment %}
+    {% comment %} with `hide_title: true`. {% endcomment %}
     {%- if page.title and page.hide_title != true and page.hide_intro != true -%}
         <h1 class="page-heading">{{ page.title }}</h1>
     {%- endif -%}
-    
-    <!-- ========================== -->
-    <!-- MAIN CONTENT AREA          -->
-    <!-- ========================== -->
-    <!-- Homepage content rendered from Markdown or HTML -->
-    <!-- Can include hero sections, feature cards, etc. -->
+
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} SITE SUBTITLE (HOME HERO)  {% endcomment %}
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} `site.subtitle` reads here, on the home hero, instead of in the {% endcomment %}
+    {% comment %} navbar, where it competed with the menubar for bar width (#405). {% endcomment %}
+    {% comment %} Suppressed alongside the heading, so a custom hero that supplies {% endcomment %}
+    {% comment %} its own copy is not doubled up. {% endcomment %}
+    {%- assign _subtitle = site.subtitle | strip -%}
+    {%- if _subtitle != "" and page.hide_title != true and page.hide_intro != true -%}
+        <p class="site-subtitle-text home-subtitle lead text-body-secondary">{{ _subtitle }}</p>
+    {%- endif -%}
+
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} MAIN CONTENT AREA          {% endcomment %}
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} Homepage content rendered from Markdown or HTML {% endcomment %}
+    {% comment %} Can include hero sections, feature cards, etc. {% endcomment %}
     {{ content }}
 
-    <!-- ========================== -->
-    <!-- RSS SUBSCRIPTION LINK      -->
-    <!-- ========================== -->
-    <!-- Provides easy access to RSS feed for blog updates. -->
-    <!-- Opt out on landing/showcase homepages with `rss_subscribe: false`. -->
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} RSS SUBSCRIPTION LINK      {% endcomment %}
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} Provides easy access to RSS feed for blog updates. {% endcomment %}
+    {% comment %} Opt out on landing/showcase homepages with `rss_subscribe: false`. {% endcomment %}
     {%- unless page.rss_subscribe == false -%}
     <p class="rss-subscribe">
         subscribe <a href="{{ "/feed.xml" | relative_url }}">via RSS</a>

data/_layouts/index.html

@@ -2,7 +2,7 @@
 # Feature: ZER0-019
 layout: root
 ---
-<!--
+{% comment %}
   ===================================================================
   INDEX LAYOUT - Search indexing template
   ===================================================================
@@ -40,16 +40,16 @@ layout: root
   - Provides proper container context for search tools
   - Maintains consistent navigation patterns
   ===================================================================
--->
+{% endcomment %}
 
-<!-- ================================ -->
-<!-- SEARCH INDEX CONTAINER          -->
-<!-- ================================ -->
-<!-- Full-width container optimized for search interfaces and content discovery -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} SEARCH INDEX CONTAINER          {% endcomment %}
+{% comment %} ================================ {% endcomment %}
+{% comment %} Full-width container optimized for search interfaces and content discovery {% endcomment %}
 <div id="search-index" class="container-fluid pt-5 py-5">
-    <!-- ========================== -->
-    <!-- SEARCH CONTENT AREA        -->
-    <!-- ========================== -->
-    <!-- Main content area for search forms, results, filters, and indexing -->
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} SEARCH CONTENT AREA        {% endcomment %}
+    {% comment %} ========================== {% endcomment %}
+    {% comment %} Main content area for search forms, results, filters, and indexing {% endcomment %}
     {{ content }}
 </div>

data/_layouts/landing.html

@@ -2,7 +2,7 @@
 # Feature: ZER0-019
 layout: root
 ---
-<!--
+{% comment %}
   ===================================================================
   LANDING LAYOUT - Welcome page for first-time visitors
   ===================================================================
@@ -43,7 +43,7 @@ layout: root
   - Custom CSS for enhanced styling
   - Responsive images and icons
   ===================================================================
--->
+{% endcomment %}
 
 {%- comment -%}
   Landing copy is data-driven via _data/landing.yml. Defaults shipped with the
@@ -53,9 +53,9 @@ layout: root
 {%- assign landing = site.data.landing -%}
 {%- assign github_url = site.resources.github_repo | default: "" | join: "" -%}
 
-<!-- ================================ -->
-<!-- HERO SECTION                     -->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} HERO SECTION                     {% endcomment %}
+{% comment %} ================================ {% endcomment %}
 <div class="bg-primary zer0-bg-hero text-white position-relative overflow-hidden landing-hero">
     <div class="container-xl py-5 px-4 px-md-5">
         <div class="row align-items-center min-vh-50 g-4 g-lg-5">
@@ -130,9 +130,9 @@ layout: root
     </div>
 </div>
 
-<!-- ================================ -->
-<!-- MAIN CONTENT AREA               -->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} MAIN CONTENT AREA               {% endcomment %}
+{% comment %} ================================ {% endcomment %}
 {% include landing/landing-quick-links.html %}
 
 {%- comment -%}
@@ -145,9 +145,9 @@ layout: root
     {{ content }}
 </div>
 
-<!-- ================================ -->
-<!-- FEATURES SECTION (data-driven)   -->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} FEATURES SECTION (data-driven)   {% endcomment %}
+{% comment %} ================================ {% endcomment %}
 {%- if landing.features.items -%}
 <section id="features" class="zer0-section bg-body-tertiary" aria-labelledby="features-heading">
   <div class="container-xl py-5 px-4 px-md-5">
@@ -179,9 +179,9 @@ layout: root
 </section>
 {%- endif -%}
 
-<!-- ================================ -->
-<!-- QUICK START SECTION (data-driven)-->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} QUICK START SECTION (data-driven){% endcomment %}
+{% comment %} ================================ {% endcomment %}
 {%- comment -%}
   Rendered only when the site ships a `get_started` block in
   _data/landing.yml. The install cards advertise THEME installation
@@ -203,7 +203,7 @@ layout: root
 </section>
 {%- endif -%}
 
-<!-- ================================ -->
-<!-- AUTHOR / E-E-A-T SECTION        -->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} AUTHOR / E-E-A-T SECTION        {% endcomment %}
+{% comment %} ================================ {% endcomment %}
 {% include components/author-eeat.html %}