jekyll-theme-zer0 1.29.0 → 1.31.0

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

data/_layouts/note.html

@@ -5,7 +5,7 @@ layout: default
 {% assign page_absolute_url = page.url | absolute_url %}
 {% assign linkedin_share_title = page.title | default: site.title | strip_html | strip_newlines | strip %}
 {% assign linkedin_share_description = page.description | default: page.excerpt | default: site.description | strip_html | strip_newlines | strip %}
-<!--
+{% comment %}
   ===================================================================
   NOTE LAYOUT - Quick Notes and Reference Display
   ===================================================================
@@ -36,21 +36,22 @@ layout: default
   - Bootstrap 5 components
   - Giscus comments (optional)
   ===================================================================
--->
+{% endcomment %}
 
-<article id="main" class="note-article h-entry" role="main" itemscope itemtype="https://schema.org/Article">
+{% comment %} No main role and no generic main id — see article.html (issue #484). {% endcomment %}
+<article class="note-article h-entry" itemscope itemtype="https://schema.org/Article">
   
-  <!-- ================================ -->
-  <!-- NOTE HEADER                      -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NOTE HEADER                      {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <header class="note-header mb-4">
     <h1 id="page-title" class="note-title p-name" itemprop="headline">
       {{ page.title }}
     </h1>
     
-    <!-- Note Metadata -->
+    {% comment %} Note Metadata {% endcomment %}
     <div class="note-meta text-muted mb-3">
-      <!-- Author -->
+      {% comment %} Author {% endcomment %}
       {% if page.author %}
         <span class="note-author" itemprop="author" itemscope itemtype="https://schema.org/Person">
           {% include components/author-card.html author=page.author style="inline" name_itemprop="name" %}
@@ -58,7 +59,7 @@ layout: default
         <span class="mx-2">•</span>
       {% endif %}
       
-      <!-- Publication Date -->
+      {% comment %} Publication Date {% endcomment %}
       {% if page.date %}
         <time class="note-date dt-published" datetime="{{ page.date | date_to_xmlschema }}" itemprop="datePublished">
           <i class="bi bi-calendar me-1"></i>
@@ -67,7 +68,7 @@ layout: default
         <span class="mx-2">•</span>
       {% endif %}
       
-      <!-- Reading Time -->
+      {% comment %} Reading Time {% endcomment %}
       {% assign words = content | number_of_words %}
       {% assign minutes = words | divided_by: 200 %}
       {% if minutes < 1 %}{% assign minutes = 1 %}{% endif %}
@@ -76,7 +77,7 @@ layout: default
         {{ minutes }} min read
       </span>
       
-      <!-- Last Modified -->
+      {% comment %} Last Modified {% endcomment %}
       {% if page.lastmod %}
         <span class="mx-2">•</span>
         <span class="note-updated" itemprop="dateModified" content="{{ page.lastmod | date_to_xmlschema }}">
@@ -85,7 +86,7 @@ layout: default
         </span>
       {% endif %}
       
-      <!-- Difficulty Badge -->
+      {% comment %} Difficulty Badge {% endcomment %}
       {% if page.difficulty %}
         <span class="mx-2">•</span>
         <span class="note-difficulty">
@@ -103,7 +104,7 @@ layout: default
       {% endif %}
     </div>
     
-    <!-- Tags -->
+    {% comment %} Tags {% endcomment %}
     {% comment %} Link tag badges only when a tags index exists (configurable via
        `tags_page`); otherwise render plain badges so remote-theme consumers
        without a /tags/ page don't get 404 links. See issue #204. {% endcomment %}
@@ -123,7 +124,7 @@ layout: default
       </div>
     {% endif %}
     
-    <!-- Categories -->
+    {% comment %} Categories {% endcomment %}
     {% if page.categories and page.categories.size > 0 %}
       <div class="note-categories mb-3">
         <i class="bi bi-folder me-1"></i>
@@ -136,7 +137,7 @@ layout: default
       </div>
     {% endif %}
     
-    <!-- Description -->
+    {% comment %} Description {% endcomment %}
     {% if page.description %}
       <div class="note-description lead mb-4" itemprop="description">
         {{ page.description }}
@@ -144,26 +145,26 @@ layout: default
     {% endif %}
   </header>
   
-  <!-- ================================ -->
-  <!-- NOTE CONTENT                     -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NOTE CONTENT                     {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <div class="note-content e-content" itemprop="articleBody">
     {{ content }}
   </div>
 
-  <!-- ================================ -->
-  <!-- AUTHOR BIO SECTION               -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} AUTHOR BIO SECTION               {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% if page.author and page.author_profile != false %}
     {% include components/author-bio.html author=page.author %}
   {% endif %}
 
-  <!-- ================================ -->
-  <!-- NOTE FOOTER                      -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NOTE FOOTER                      {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <footer class="note-footer mt-5 pt-4 border-top">
     
-    <!-- Share Buttons -->
+    {% comment %} Share Buttons {% endcomment %}
     {% if page.share != false %}
       <div class="share-buttons mb-4">
         <h5 class="mb-3">Share this note</h5>
@@ -190,7 +191,7 @@ layout: default
       </div>
     {% endif %}
     
-    <!-- Related Notes -->
+    {% comment %} Related Notes {% endcomment %}
     {% if site.notes.size > 1 %}
       <div class="related-notes mt-5">
         <h5 class="mb-3">Related Notes</h5>
@@ -238,28 +239,28 @@ layout: default
     {% endif %}
   </footer>
   
-  <!-- ================================ -->
-  <!-- COMMENTS SECTION                 -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} COMMENTS SECTION                 {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% if page.comments != false and site.giscus.enabled %}
     <div class="note-comments mt-5 pt-4 border-top">
       <h5 class="mb-4">Comments</h5>
       {% include content/giscus.html %}
     </div>
   {% endif %}
-    <!-- ================================ -->
-  <!-- BACKLINKS — "Linked mentions"    -->
-  <!-- ================================ -->
-  <!-- Obsidian-style panel of pages that wiki-link or markdown-link to this note. -->
-  <!-- Disable per-page with `backlinks: false` in front matter. -->
+    {% comment %} ================================ {% endcomment %}
+  {% comment %} BACKLINKS — "Linked mentions"    {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} Obsidian-style panel of pages that wiki-link or markdown-link to this note. {% endcomment %}
+  {% comment %} Disable per-page with `backlinks: false` in front matter. {% endcomment %}
   {% include content/backlinks.html %}
 
 </article>
 
-<!-- ================================ -->
-<!-- NAVIGATION                       -->
-<!-- ================================ -->
-<!-- Previous/Next Note Navigation -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} NAVIGATION                       {% endcomment %}
+{% comment %} ================================ {% endcomment %}
+{% comment %} Previous/Next Note Navigation {% endcomment %}
 {% assign notes = site.notes | sort: 'date' | reverse %}
 {% assign current_index = nil %}
 {% for note in notes %}
@@ -304,7 +305,7 @@ layout: default
   </nav>
 {% endif %}
 
-<!-- Schema.org metadata -->
+{% comment %} Schema.org metadata {% endcomment %}
 <script type="application/ld+json">
 {
   "@context": "https://schema.org",

data/_layouts/notebook.html

@@ -2,7 +2,7 @@
 # Features: ZER0-012, ZER0-019, ZER0-035
 layout: default
 ---
-<!--
+{% comment %}
   ===================================================================
   NOTEBOOK LAYOUT - Jupyter Notebook Display
   ===================================================================
@@ -32,21 +32,22 @@ layout: default
   - Rouge syntax highlighter (Jekyll default)
   - Bootstrap 5 components
   ===================================================================
--->
+{% endcomment %}
 
-<article id="main" class="notebook-article h-entry" role="main" itemscope itemtype="https://schema.org/TechArticle">
+{% comment %} No main role and no generic main id — see article.html (issue #484). {% endcomment %}
+<article class="notebook-article h-entry" itemscope itemtype="https://schema.org/TechArticle">
   
-  <!-- ================================ -->
-  <!-- NOTEBOOK HEADER                  -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NOTEBOOK HEADER                  {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <header class="notebook-header mb-4">
     <h1 id="page-title" class="notebook-title p-name" itemprop="headline">
       {{ page.title }}
     </h1>
     
-    <!-- Notebook Metadata -->
+    {% comment %} Notebook Metadata {% endcomment %}
     <div class="notebook-meta text-muted mb-3">
-      <!-- Author -->
+      {% comment %} Author {% endcomment %}
       {% if page.author %}
         <span class="notebook-author" itemprop="author" itemscope itemtype="https://schema.org/Person">
           {% include components/author-card.html author=page.author style="inline" name_itemprop="name" %}
@@ -54,7 +55,7 @@ layout: default
         <span class="mx-2">•</span>
       {% endif %}
       
-      <!-- Publication Date -->
+      {% comment %} Publication Date {% endcomment %}
       {% if page.date %}
         <time class="notebook-date dt-published" datetime="{{ page.date | date_to_xmlschema }}" itemprop="datePublished">
           <i class="bi bi-calendar me-1"></i>
@@ -63,7 +64,7 @@ layout: default
         <span class="mx-2">•</span>
       {% endif %}
       
-      <!-- Reading Time -->
+      {% comment %} Reading Time {% endcomment %}
       {% assign words = content | number_of_words %}
       {% assign minutes = words | divided_by: 200 %}
       {% if minutes < 1 %}{% assign minutes = 1 %}{% endif %}
@@ -72,7 +73,7 @@ layout: default
         {{ minutes }} min read
       </span>
       
-      <!-- Last Modified -->
+      {% comment %} Last Modified {% endcomment %}
       {% if page.lastmod %}
         <span class="mx-2">•</span>
         <span class="notebook-updated" itemprop="dateModified" content="{{ page.lastmod | date_to_xmlschema }}">
@@ -81,7 +82,7 @@ layout: default
         </span>
       {% endif %}
       
-      <!-- Kernel Info -->
+      {% comment %} Kernel Info {% endcomment %}
       {% if page.jupyter_metadata %}
         <span class="mx-2">•</span>
         <span class="notebook-kernel">
@@ -91,7 +92,7 @@ layout: default
       {% endif %}
     </div>
     
-    <!-- Tags -->
+    {% comment %} Tags {% endcomment %}
     {% comment %} Link tag badges only when a tags index exists (configurable via
        `tags_page`); otherwise render plain badges so remote-theme consumers
        without a /tags/ page don't get 404 links. See issue #204. {% endcomment %}
@@ -111,7 +112,7 @@ layout: default
       </div>
     {% endif %}
     
-    <!-- Categories -->
+    {% comment %} Categories {% endcomment %}
     {% if page.categories and page.categories.size > 0 %}
       <div class="notebook-categories mb-3">
         <i class="bi bi-folder me-1"></i>
@@ -124,7 +125,7 @@ layout: default
       </div>
     {% endif %}
     
-    <!-- Description -->
+    {% comment %} Description {% endcomment %}
     {% if page.description %}
       <div class="notebook-description lead mb-4" itemprop="description">
         {{ page.description }}
@@ -132,26 +133,26 @@ layout: default
     {% endif %}
   </header>
   
-  <!-- ================================ -->
-  <!-- NOTEBOOK CONTENT                 -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NOTEBOOK CONTENT                 {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <div class="notebook-content e-content" itemprop="articleBody">
     {{ content }}
   </div>
 
-  <!-- ================================ -->
-  <!-- AUTHOR BIO SECTION               -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} AUTHOR BIO SECTION               {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% if page.author and page.author_profile != false %}
     {% include components/author-bio.html author=page.author %}
   {% endif %}
 
-  <!-- ================================ -->
-  <!-- NOTEBOOK FOOTER                  -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} NOTEBOOK FOOTER                  {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   <footer class="notebook-footer mt-5 pt-4 border-top">
     
-    <!-- Share Buttons -->
+    {% comment %} Share Buttons {% endcomment %}
     {% if page.share != false %}
       <div class="share-buttons mb-4">
         <h5 class="mb-3">Share this notebook</h5>
@@ -172,7 +173,7 @@ layout: default
       </div>
     {% endif %}
     
-    <!-- Download Original Notebook -->
+    {% comment %} Download Original Notebook {% endcomment %}
     <div class="download-notebook mb-4">
       <a href="https://raw.githubusercontent.com/{{ site.repository }}/{{ site.branch | default: 'main' }}/pages/_notebooks/{{ page.slug }}.ipynb" 
          class="btn btn-outline-secondary btn-sm" download>
@@ -180,7 +181,7 @@ layout: default
       </a>
     </div>
     
-    <!-- Related Notebooks -->
+    {% comment %} Related Notebooks {% endcomment %}
     {% if site.notebooks.size > 1 %}
       <div class="related-notebooks mt-5">
         <h5 class="mb-3">Related Notebooks</h5>
@@ -221,9 +222,9 @@ layout: default
     {% endif %}
   </footer>
   
-  <!-- ================================ -->
-  <!-- COMMENTS SECTION                 -->
-  <!-- ================================ -->
+  {% comment %} ================================ {% endcomment %}
+  {% comment %} COMMENTS SECTION                 {% endcomment %}
+  {% comment %} ================================ {% endcomment %}
   {% if page.comments != false and site.giscus.enabled %}
     <div class="notebook-comments mt-5 pt-4 border-top">
       <h5 class="mb-4">Comments</h5>
@@ -233,10 +234,10 @@ layout: default
   
 </article>
 
-<!-- ================================ -->
-<!-- NAVIGATION                       -->
-<!-- ================================ -->
-<!-- Previous/Next Notebook Navigation -->
+{% comment %} ================================ {% endcomment %}
+{% comment %} NAVIGATION                       {% endcomment %}
+{% comment %} ================================ {% endcomment %}
+{% comment %} Previous/Next Notebook Navigation {% endcomment %}
 {% assign notebooks = site.notebooks | sort: 'date' | reverse %}
 {% assign current_index = nil %}
 {% for notebook in notebooks %}
@@ -281,7 +282,7 @@ layout: default
   </nav>
 {% endif %}
 
-<!-- Schema.org metadata -->
+{% comment %} Schema.org metadata {% endcomment %}
 <script type="application/ld+json">
 {
   "@context": "https://schema.org",