jekyll-theme-zer0 1.28.0 → 1.30.0

data/_layouts/cookbook.html

@@ -0,0 +1,88 @@
+---
+# Feature: ZER0-084
+layout: default
+---
+{%- comment -%}
+  Layout: cookbook.html
+  Extends: default.html
+  Purpose: Landing page for one cookbook — cover, introduction, a jump-nav of
+           its courses, and the full recipe index grouped by course.
+  Front matter required: layout, title, cookbook (slug shared with its recipes)
+  Front matter optional: subtitle, description, image/preview, author,
+    grouped (false for one flat grid)
+  Notes: Recipes belong to a cookbook by matching its `cookbook:` slug. Omit
+         `cookbook:` here and the page indexes EVERY recipe on the site, which
+         is what a single-cookbook site wants.
+{%- endcomment -%}
+
+{%- assign _cb_slug = page.cookbook -%}
+{%- if _cb_slug -%}
+  {%- assign _cb_recipes = site.recipes | where_exp: "doc", "doc.layout != 'cookbook'" | where: "cookbook", _cb_slug -%}
+{%- else -%}
+  {%- assign _cb_recipes = site.recipes | where_exp: "doc", "doc.layout != 'cookbook'" -%}
+{%- endif -%}
+{%- assign _cb_courses = _cb_recipes | map: "course" | compact | uniq -%}
+{%- assign _cb_image = page.image | default: page.preview -%}
+
+<div class="cookbook">
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} COVER                            {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
+  <header class="cookbook-header">
+    <div class="row g-4 align-items-center">
+      {%- if _cb_image -%}
+      <div class="col-8 col-sm-5 col-md-4 col-lg-3">
+        <div class="cookbook-cover">
+          {%- include components/preview-image.html src=_cb_image alt=page.title class="" loading="eager" -%}
+        </div>
+      </div>
+      {%- endif -%}
+      <div class="col">
+        <h1 id="page-title" class="cookbook-title">{{ page.title }}</h1>
+        {%- if page.subtitle -%}
+        <p class="lead mb-2">{{ page.subtitle }}</p>
+        {%- endif -%}
+        {%- if page.author -%}
+        <p class="text-body-secondary small mb-2">By {{ page.author }}</p>
+        {%- endif -%}
+        <p class="text-body-secondary mb-3">
+          <i class="bi bi-egg-fried me-1" aria-hidden="true"></i>{{ _cb_recipes.size }} {% if _cb_recipes.size == 1 %}recipe{% else %}recipes{% endif %}
+          {%- if _cb_courses.size > 0 %} <span class="mx-1" aria-hidden="true">•</span> {{ _cb_courses.size }} {% if _cb_courses.size == 1 %}course{% else %}courses{% endif %}{% endif -%}
+        </p>
+        {%- if page.description -%}
+        <p class="cookbook-description">{{ page.description }}</p>
+        {%- endif -%}
+      </div>
+    </div>
+  </header>
+
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} ABOUT (the markdown body)        {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
+  {%- assign _cb_body = content | strip -%}
+  {%- if _cb_body != "" -%}
+  <section class="cookbook-about">
+    {{ content }}
+  </section>
+  {%- endif -%}
+
+  {% 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 -%}
+      {%- if _cb_courses contains _cb_pair[0] -%}
+      <a class="btn btn-sm btn-outline-secondary" href="#course-{{ _cb_pair[0] }}">
+        <i class="bi {{ _cb_pair[1].icon | default: 'bi-journal-bookmark' }} me-1" aria-hidden="true"></i>{{ _cb_pair[1].title | default: _cb_pair[0] | escape }}
+      </a>
+      {%- endif -%}
+    {%- endfor -%}
+  </nav>
+  {%- endif -%}
+
+  {% 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,42 +83,45 @@ 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.
-          Skipped on layouts that render their own page header (article, note)
-          to avoid duplicate H1s. Authors can also opt-out per page via
-          `hide_intro: true` in front matter.
+          Skipped on layouts that render their own page header (article, note,
+          recipe, cookbook) to avoid duplicate H1s. Authors can also opt-out
+          per page via `hide_intro: true` in front matter.
         {%- endcomment -%}
         {% assign _skip_intro = false %}
-        {% if page.layout == "article" or page.layout == "note" or page.hide_intro %}
+        {% if page.layout == "article" or page.layout == "note" or page.layout == "recipe" or page.layout == "cookbook" or page.hide_intro %}
           {% assign _skip_intro = true %}
         {% endif %}
         {% unless _skip_intro %}
           {% 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,36 @@ 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 %} 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 %}

data/_layouts/news.html

@@ -3,7 +3,7 @@
 layout: root
 source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
 ---
-<!--
+{% comment %}
   ===================================================================
   NEWS LAYOUT - Main News Homepage with Section Style Support
   ===================================================================
@@ -49,7 +49,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   
   Note: All cards are inlined to avoid Liquid nesting depth issues
   ===================================================================
--->
+{% endcomment %}
 
 {% comment %} 
   WARNING: section_style is required in front matter!
@@ -92,9 +92,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   {% if _tags_index_page %}{% assign _tags_linkable = true %}{% endif %}
 {% endif %}
 
-<!-- ================================ -->
-<!-- NEWS HEADER                      -->
-<!-- ================================ -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} NEWS HEADER                      {% endcomment %}
+{% comment %} ================================ {% endcomment %}
 <div class="container-fluid bg-dark text-white py-3 mb-4">
   <div class="container">
     <div class="row align-items-center">
@@ -131,18 +131,18 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   </div>
 </div>
 
-<!-- Not a <main>: root.html already provides the single <main id="main-content">
-     landmark; a nested <main> here would duplicate it (issue #299). -->
+{% comment %} Not a <main>: root.html already provides the single <main id="main-content">
+     landmark; a nested <main> here would duplicate it (issue #299). {% endcomment %}
 <div class="container">
 
 {% if section_style == "magazine" %}
-  <!-- ================================ -->
-  <!-- MAGAZINE STYLE LAYOUT            -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} MAGAZINE STYLE LAYOUT            {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
 
-  <!-- ================================ -->
-  <!-- HERO - BREAKING NEWS             -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} HERO - BREAKING NEWS             {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% assign breaking_posts = all_posts | where: "breaking", true %}
   {% assign hero_post = breaking_posts | first %}
 
@@ -215,9 +215,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   </section>
   {% endif %}
 
-  <!-- ================================ -->
-  <!-- SECTION QUICK NAVIGATION         -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} SECTION QUICK NAVIGATION         {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <section class="section-nav mb-5">
     <div class="row row-cols-2 row-cols-md-3 row-cols-lg-6 g-3">
       {% for sec_name in news_sections %}
@@ -242,9 +242,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
     </div>
   </section>
 
-  <!-- ================================ -->
-  <!-- FEATURED STORIES                 -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} FEATURED STORIES                 {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% assign featured_posts = all_posts | where: "featured", true %}
   {% if featured_posts.size > 0 %}
   <section class="featured-section mb-5">
@@ -255,7 +255,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
     </div>
     
     <div class="row g-4">
-      <!-- Main Featured Post -->
+      {% comment %} Main Featured Post {% endcomment %}
       {% assign main_featured = featured_posts | first %}
       <div class="col-lg-6">
         <div class="card h-100 border-0 shadow">
@@ -300,7 +300,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
         </div>
       </div>
       
-      <!-- Secondary Featured Posts -->
+      {% comment %} Secondary Featured Posts {% endcomment %}
       <div class="col-lg-6">
         <div class="row row-cols-1 row-cols-md-2 g-4">
           {% for fpost in featured_posts offset:1 limit:4 %}
@@ -334,9 +334,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   </section>
   {% endif %}
 
-  <!-- ================================ -->
-  <!-- POSTS BY SECTION                 -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} POSTS BY SECTION                 {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% for sec_name in news_sections limit: 3 %}
     {% assign section_posts = all_posts | where_exp: "post", "post.categories contains sec_name" %}
     {% assign _sec_nav = site.data.navigation.posts | where: "title", sec_name | first %}
@@ -395,9 +395,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   {% endfor %}
 
 {% elsif section_style == "grid" %}
-  <!-- ================================ -->
-  <!-- GRID STYLE LAYOUT                -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} GRID STYLE LAYOUT                {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <section class="grid-section mb-5">
     <h2 class="h4 mb-4">
       <i class="bi bi-grid me-2"></i>All Articles
@@ -453,9 +453,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   </section>
 
 {% elsif section_style == "list" %}
-  <!-- ================================ -->
-  <!-- LIST STYLE LAYOUT                -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} LIST STYLE LAYOUT                {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <section class="list-section mb-5">
     <h2 class="h4 mb-4">
       <i class="bi bi-list-ul me-2"></i>Latest Articles
@@ -509,9 +509,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
 
 {% endif %}
 
-  <!-- ================================ -->
-  <!-- LATEST POSTS                     -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} LATEST POSTS                     {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% if section_style == "magazine" %}
   <section class="latest-section mb-5">
     <div class="d-flex justify-content-between align-items-center mb-4">
@@ -557,9 +557,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   </section>
   {% endif %}
 
-  <!-- ================================ -->
-  <!-- PAGE CONTENT (if any)            -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} PAGE CONTENT (if any)            {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% if content != blank %}
   <section class="page-content mb-5">
     <div class="card border-0 shadow-sm">
@@ -570,12 +570,12 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
   </section>
   {% endif %}
 
-  <!-- ================================ -->
-  <!-- TAGS & ARCHIVES                  -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} TAGS & ARCHIVES                  {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <section class="footer-widgets mb-5">
     <div class="row g-4">
-      <!-- Popular Tags -->
+      {% comment %} Popular Tags {% endcomment %}
       <div class="col-md-6">
         <div class="card h-100 border-0 bg-body-tertiary">
           <div class="card-body">
@@ -610,7 +610,7 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
         </div>
       </div>
       
-      <!-- Archives -->
+      {% comment %} Archives {% endcomment %}
       <div class="col-md-6">
         <div class="card h-100 border-0 bg-body-tertiary">
           <div class="card-body">
@@ -661,9 +661,9 @@ source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
     </div>
   </section>
 
-  <!-- ================================ -->
-  <!-- NEWSLETTER SIGNUP                -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NEWSLETTER SIGNUP                {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% comment %}
     Renders only when it can actually do something: a configured form
     endpoint (news.newsletter.endpoint) posts for real; otherwise a