jekyll-theme-zer0 1.23.0 → 1.25.0

data/_includes/navigation/sidebar-nav.html

@@ -0,0 +1,30 @@
+{%- comment -%}
+  Component:   sidebar-nav
+  Path:        _includes/navigation/sidebar-nav.html
+  Purpose:     Render the resolved sidebar navigation content for the current
+               page. Expects navigation/sidebar-config.html to have been
+               included first in the same render context (it sets
+               `sidebar_nav`). Shared by navigation/sidebar-left.html and
+               navigation/unified-drawer.html so desktop sidebar and mobile
+               drawer can never drift apart.
+  Params:      id (string, optional) — id attribute for the content wrapper
+  Depends on:  navigation/sidebar-config.html (resolver),
+               navigation/sidebar-folders.html ("collection" mode),
+               navigation/sidebar-categories.html ("categories"/"tags" modes),
+               navigation/nav-tree.html (curated _data/navigation/*.yml modes)
+  Notes:       Renders nothing when sidebar_nav is nil or its data is empty —
+               callers gate the surrounding column on `sidebar_has_content`.
+{%- endcomment -%}
+{%- if sidebar_nav == "collection" -%}
+<div class="nav-tree"{% if include.id %} id="{{ include.id }}"{% endif %} data-nav-tree>
+  {% include navigation/sidebar-folders.html %}
+</div>
+{%- elsif sidebar_nav == "categories" or sidebar_nav == "tags" -%}
+<div class="nav-tree nav-tree--categories"{% if include.id %} id="{{ include.id }}"{% endif %} data-nav-tree>
+  {% include navigation/sidebar-categories.html taxonomy=sidebar_nav %}
+</div>
+{%- elsif sidebar_nav -%}
+<nav class="w-100 nav-tree"{% if include.id %} id="{{ include.id }}"{% endif %} data-nav-tree aria-label="Section navigation">
+  {% include navigation/nav-tree.html nav=sidebar_nav %}
+</nav>
+{%- endif -%}

data/_includes/navigation/sidebar-right.html

@@ -1,3 +1,4 @@
+{% comment %} Features: ZER0-008, ZER0-010 {% endcomment %}
 <!-- 
   file: sidebar-right.html 
   path: _includes/sidebar-right.html

data/_includes/navigation/toc-fab.html

@@ -3,15 +3,9 @@
   footer stacking context with back-to-top and does not cover the powered-by
   row when the user scrolls to the page bottom.
 {%- endcomment -%}
-{%- assign _effective_sidebar = page.sidebar -%}
-{%- if _effective_sidebar == nil -%}
-  {%- if page.post_type == "featured" or page.post_type == "breaking" -%}
-    {%- assign _effective_sidebar = false -%}
-  {%- else -%}
-    {%- assign _effective_sidebar = true -%}
-  {%- endif -%}
-{%- endif -%}
-{%- if _effective_sidebar != false -%}
+{%- comment -%} Shared visibility resolver — sets sidebar_enabled {%- endcomment -%}
+{%- include navigation/sidebar-config.html -%}
+{%- if sidebar_enabled -%}
 <div class="position-fixed bd-toc-fab d-lg-none" id="tocFab">
   <button class="btn btn-primary rounded-circle shadow-lg p-0 bd-toc-toggle"
           type="button"

data/_includes/navigation/unified-drawer.html

@@ -60,20 +60,13 @@
   <div class="offcanvas-body tab-content overflow-auto">
     <div class="tab-pane fade show active" id="zer0-drawer-pane-browse"
          role="tabpanel" aria-labelledby="zer0-drawer-tab-browse">
-      {%- if page.sidebar.nav == "auto" -%}
-        <div class="list-group nav-tree">
-          {% assign folders = site.pages | where_exp: "item", "item.path contains 'index.md'" | sort: 'path' %}
-          {% include navigation/sidebar-folders.html folders=folders %}
-        </div>
-      {%- elsif page.sidebar.nav == "categories" -%}
-        <div class="nav-tree nav-tree--categories">
-          {% assign categories = site.categories | sort %}
-          {% include navigation/sidebar-categories.html categories=categories %}
-        </div>
-      {%- elsif page.sidebar.nav -%}
-        <nav aria-label="Section navigation">
-          {% include navigation/nav-tree.html nav=page.sidebar.nav %}
-        </nav>
+      {%- comment -%}
+        Same resolver + renderer as sidebar-left.html so the drawer's Browse
+        tab can never drift from the desktop sidebar.
+      {%- endcomment -%}
+      {% include navigation/sidebar-config.html %}
+      {%- if sidebar_has_content -%}
+        {% include navigation/sidebar-nav.html %}
       {%- else -%}
         <p class="text-body-secondary small mb-0">No sidebar configured for this page.</p>
       {%- endif -%}

data/_includes/obsidian/full-graph.html

@@ -1,3 +1,4 @@
+{% comment %} Features: ZER0-044, ZER0-045 {% endcomment %}
 <style>
   /* Scoped to the graph page so we don't leak into other docs. */
   #obsidian-graph {

data/_includes/setup/wizard.html

@@ -1,3 +1,4 @@
+{% comment %} Feature: ZER0-067 {% endcomment %}
 <!--
   ===================================================================
   SETUP WIZARD — Interactive _config.yml Generator

data/_includes/stats/stats-categories.html

@@ -1,3 +1,4 @@
+{% comment %} Feature: ZER0-043 {% endcomment %}
 <!-- ================================================ -->
 <!-- CATEGORIES ANALYSIS SECTION                     -->
 <!-- Top categories with post counts                 -->

data/_includes/stats/stats-header.html

@@ -1,3 +1,4 @@
+{% comment %} Feature: ZER0-043 {% endcomment %}
 <!-- ================================================ -->
 <!-- STATS PAGE HEADER                               -->
 <!-- Title, description, and metadata display        -->

data/_includes/stats/stats-metrics.html

@@ -1,3 +1,4 @@
+{% comment %} Feature: ZER0-043 {% endcomment %}
 <div id="metrics" class="row mb-5">
   <div class="col-12">
     <div class="card shadow-sm">

data/_includes/stats/stats-overview.html

@@ -1,3 +1,4 @@
+{% comment %} Feature: ZER0-043 {% endcomment %}
 <div id="overview" class="mb-5">
   <!-- Section Header -->
   <div class="text-center mb-4">

data/_includes/stats/stats-tags.html

@@ -1,3 +1,4 @@
+{% comment %} Feature: ZER0-043 {% endcomment %}
 <!-- ================================================ -->
 <!-- TAGS ANALYSIS SECTION                           -->
 <!-- Top tags with usage counts                      -->

data/_layouts/admin.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-050
 layout: root
 ---
 <!--

data/_layouts/article.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-035, ZER0-064
 layout: default
 ---
 <!--

data/_layouts/author.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-061
 layout: default
 hide_intro: true
 ---

data/_layouts/authors.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-061
 layout: default
 ---
 <!--

data/_layouts/collection.html

@@ -1,4 +1,5 @@
 ---
+# Feature: ZER0-019
 layout: default
 ---
 <!--

data/_layouts/default.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-001, ZER0-008, ZER0-019
 layout: root
 ---
 <!--
@@ -45,53 +46,29 @@ layout: root
 -->
 
 {%- comment -%}
-  Resolve effective sidebar visibility. Precedence:
-    1. page.sidebar in front matter wins (true | false | hash)
-    2. Otherwise, post_type=featured|breaking → false (full-bleed reading)
-    3. Otherwise, default to true
-  This is the single source of truth so child layouts (article.html, note.html)
-  do not need to mutate page state.
+  Sidebar visibility + nav mode are resolved by the shared include below
+  (single source of truth, also used by core/header.html and the sidebar
+  includes). It sets:
+    sidebar_enabled     — false when the page opts out (`sidebar: false`,
+                          or featured/breaking post_type by default)
+    sidebar_has_content — true only when the resolved nav mode will render;
+                          `sidebar: true` without a resolvable nav still
+                          enables the right TOC but must not reserve an
+                          empty left column.
 {%- endcomment -%}
-{%- assign _effective_sidebar = page.sidebar -%}
-{%- if _effective_sidebar == nil -%}
-  {%- if page.post_type == "featured" or page.post_type == "breaking" -%}
-    {%- assign _effective_sidebar = false -%}
-  {%- else -%}
-    {%- assign _effective_sidebar = true -%}
-  {%- endif -%}
-{%- endif -%}
-
-{%- comment -%}
-  Left sidebar column is only useful when sidebar-left.html has nav to render
-  (matches header.html mobile toggle logic). `sidebar: true` without `nav`
-  still enables the right TOC but must not reserve an empty left column.
-{%- endcomment -%}
-{%- assign _sidebar_has_content = false -%}
-{%- if _effective_sidebar != false -%}
-  {%- assign _sidebar_nav = nil -%}
-  {%- if page.sidebar and page.sidebar.nav -%}
-    {%- assign _sidebar_nav = page.sidebar.nav -%}
-  {%- endif -%}
-  {%- if _sidebar_nav -%}
-    {%- if _sidebar_nav == "auto" or _sidebar_nav == "categories" -%}
-      {%- assign _sidebar_has_content = true -%}
-    {%- elsif site.data.navigation[_sidebar_nav] -%}
-      {%- assign _sidebar_has_content = true -%}
-    {%- endif -%}
-  {%- endif -%}
-{%- endif -%}
+{% include navigation/sidebar-config.html %}
 
 <!-- ================================================ -->
 <!-- MAIN LAYOUT CONTAINER                           -->
 <!-- Bootstrap responsive container with custom grid -->
 <!-- ================================================ -->
-<div class="container-xxl bd-gutter mt-3 my-md-4 bd-layout{% unless _sidebar_has_content %} bd-layout--no-sidebar{% endunless %}">
+<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 -->
-    {% if _sidebar_has_content %}
+    {% if sidebar_has_content %}
     <aside class="bd-sidebar">
         {% include navigation/sidebar-left.html %}
     </aside>
@@ -130,7 +107,7 @@ layout: root
         <!-- RIGHT SIDEBAR - Table of Contents -->
         <!-- =============================== -->
         <!-- Page outline, shortcuts, and related links (hidden on mobile) -->
-        {% unless _effective_sidebar == false %}
+        {% unless sidebar_enabled == false %}
         <div class="bd-toc text-body-secondary">
             {% include navigation/sidebar-right.html %}
         </div>

data/_layouts/home.html

@@ -1,4 +1,5 @@
 ---
+# Feature: ZER0-019
 layout: root
 ---
 <!--

data/_layouts/index.html

@@ -1,4 +1,5 @@
 ---
+# Feature: ZER0-019
 layout: root
 ---
 <!--

data/_layouts/landing.html

@@ -1,4 +1,5 @@
 ---
+# Feature: ZER0-019
 layout: root
 ---
 <!--

data/_layouts/news.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-062
 layout: root
 source: "https://getbootstrap.com/docs/5.3/examples/blog/#"
 ---

data/_layouts/note.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-035, ZER0-058
 layout: default
 ---
 {% assign page_absolute_url = page.url | absolute_url %}

data/_layouts/notebook.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-012, ZER0-019, ZER0-035
 layout: default
 ---
 <!--

data/_layouts/root.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-001, ZER0-019, ZER0-031, ZER0-060
 ---
 <!--
   ===================================================================
@@ -20,7 +21,7 @@
   - head.html: Meta tags, stylesheets, and external resources
   - svg.html: Inline SVG symbols for icons
   - header.html: Main navigation and site branding
-  - info-section.html: Site-wide announcements or notices
+  - info-section.html: Settings offcanvas (Appearance / Site / Developer)
   - footer.html: Site footer with links and copyright
   - js-cdn.html: JavaScript dependencies and custom scripts
   
@@ -87,7 +88,7 @@
         <!-- Keyboard shortcuts help modal (triggered by `?`) — page-invariant. -->
         {% include_cached components/shortcuts-modal.html %}
 
-        <!-- Site-wide information banner or announcement section -->
+        <!-- Settings offcanvas (Appearance / Site / Developer tabs) -->
         {% include components/info-section.html %}
 
         <!-- Setup banner for unconfigured sites — page-invariant. -->

data/_layouts/search.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-042
 # Bare layout that renders the client-side search index as pure JSON.
 # Used by /search.json (see search.json in the site root); downstream
 # sites get the endpoint automatically via the theme gem.

data/_layouts/section.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-063
 layout: root
 ---
 <!--

data/_layouts/setup.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-067
 layout: root
 ---
 <!--

data/_layouts/sitemap-collection.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-042
 layout: root
 ---
 <!--

data/_layouts/stats.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-043
 layout: root
 ---
 <!--

data/_layouts/tag.html

@@ -1,4 +1,5 @@
 ---
+# Feature: ZER0-019
 layout: default
 ---
 <!--

data/_layouts/welcome.html

@@ -1,4 +1,5 @@
 ---
+# Features: ZER0-019, ZER0-046
 layout: root
 ---
 <!--

data/_plugins/author_pages_generator.rb

@@ -1,3 +1,4 @@
+# Feature: ZER0-061
 # frozen_string_literal: true
 
 #

data/_plugins/obsidian_links.rb

@@ -1,3 +1,4 @@
+# Features: ZER0-044, ZER0-059
 # frozen_string_literal: true
 
 require 'digest'

data/_plugins/preview_image_generator.rb

@@ -1,3 +1,4 @@
+# Feature: ZER0-004
 # frozen_string_literal: true
 
 #

data/_plugins/search_and_sitemap_generator.rb

@@ -1,3 +1,4 @@
+# Feature: ZER0-042
 # frozen_string_literal: true
 
 #

data/_plugins/theme_version.rb

@@ -1,3 +1,4 @@
+# Feature: ZER0-021
 # frozen_string_literal: true
 
 #

data/_sass/components/_author.scss

@@ -46,9 +46,20 @@
   }
 }
 
-// Expertise chips
+// "About the Author" card: the text column sits in a flex row next to the
+// avatar. Flexbox's default `min-width: auto` propagates the widest nowrap
+// child (a long expertise badge) as the column's minimum, blowing the card —
+// and with it the whole page — past the viewport on small phones (≤340px).
+.author-card .card-body .flex-grow-1 {
+  min-width: 0;
+}
+
+// Expertise chips — allow the label to wrap instead of forcing the card wide
+// (Bootstrap badges are white-space: nowrap by default).
 .author-expertise .badge {
   font-weight: 500;
+  white-space: normal;
+  text-align: start;
 }
 
 // Shared tagline styling (full "About the Author" card + profile hero)

data/_sass/components/_footer.scss

@@ -127,6 +127,28 @@
     }
   }
 
+  // WCAG 2.5.8 target size: the dark block's text links render ~19px tall and
+  // the icon-only social links (below md) ~16px wide — under the 24px minimum.
+  // Block padding grows the tap target without changing the visual text size;
+  // icon links get an explicit minimum box. (`d-block` links — e.g. the
+  // truncated Latest Posts titles — keep their display but gain the padding.)
+  .footer-dark-block {
+    ul.list-unstyled li > a,
+    p > a {
+      display: inline-block;
+      padding-block: 0.25rem;
+    }
+
+    ul.list-inline li > a {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      gap: 0.25rem;
+      min-width: 1.75rem;
+      min-height: 1.75rem;
+    }
+  }
+
   .footer-post-link {
     max-width: 100%;
   }

data/_sass/components/_ui-enhancements.scss

@@ -26,6 +26,15 @@ img {
 // UI/UX ENHANCEMENTS - Modern, polished interactions
 // ==============================================================================
 
+// WCAG 2.5.8 target size: breadcrumb links render as bare ~19px text lines.
+// Block padding + matching negative margin grows the tap box past 24px
+// without shifting the visual baseline or the bar's height.
+.breadcrumbs .breadcrumb-item > a {
+  display: inline-block;
+  padding-block: 0.25rem;
+  margin-block: -0.25rem;
+}
+
 // Hero Section Enhancements
 // NOTE: Exclude .zer0-bg-hero so skin-specific gradients from _backgrounds.scss take precedence
 .bg-primary:not(.zer0-bg-hero) {

data/_sass/core/_docs-layout.scss

@@ -1,3 +1,4 @@
+// Feature: ZER0-008
 /*!
  * Docs layout — trimmed Bootstrap-docs-adjacent styles for zer0-mistakes.
  * Replaces the former full _docs.scss vendor snapshot (~3.2k lines).

data/_sass/core/_navbar.scss

@@ -804,33 +804,16 @@
     padding-top: 1rem;
   }
 
-  // Theme switcher (halfmoon): keep dropdown positioned within offcanvas panel
-  .bd-theme-dropdown {
-    position: relative;
-  }
-
-  .bd-theme-menu.dropdown-menu {
-    --bs-dropdown-min-width: 10.5rem;
-    z-index: 1060;
-    padding-top: 0.35rem;
-    padding-bottom: 0.35rem;
-    border-radius: var(--bs-border-radius, 0.375rem);
-    border: 1px solid var(--bs-border-color-translucent);
-  }
-
-  .bd-theme-menu .dropdown-item {
-    min-height: 0;
-    padding: 0.45rem 0.85rem;
-    font-size: 0.9375rem;
-    border-radius: calc(var(--bs-border-radius, 0.375rem) - 2px);
-    gap: 0.35rem;
-
-    &.active {
-      font-weight: 600;
-    }
-
-    .bi.ms-auto {
-      opacity: 0.9;
+  // Compact tabs on narrow panels: keep the text labels (they are the
+  // accessible names) and drop the decorative icons instead.
+  @media (max-width: 575.98px) {
+    .nav-tabs .nav-link {
+      padding: 0.6rem 0.25rem;
+      font-size: 0.8125rem;
+
+      .bi {
+        display: none;
+      }
     }
   }
 }

data/_sass/core/_obsidian.scss

@@ -204,8 +204,8 @@
 // ----------------------------------------------------------------------------
 // ID selector (not the class) is REQUIRED for the fixed position to stick:
 // the FAB is a direct child of `.zer0-bg-body`, which matches the elevation
-// rule `.zer0-bg-body > *:not(.fixed-top):not(.offcanvas):not(.modal)` in
-// _sass/theme/_backgrounds.scss (specificity 0,4,0) and forces
+// rule `.zer0-bg-body > *:not(.fixed-top):not(.position-fixed):not(.offcanvas):not(.modal)`
+// in _sass/theme/_backgrounds.scss (specificity 0,5,0) and forces
 // `position: relative; z-index: 1` — dropping the FAB into page flow at the
 // bottom. An id (1,0,0) wins, mirroring `#aiChatToggle`. See ai-chat.html.
 #obsidianLocalGraphFab.obsidian-local-graph-fab {

data/_sass/core/code-copy.scss

@@ -197,6 +197,12 @@
 
 // Copy button — shared base
 .copy {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  // WCAG 2.5.8 target size: text metrics alone yield a ~22px-tall button;
+  // guarantee the 24px minimum, and a comfortable 32px on touch screens.
+  min-height: 1.5rem;
   flex-shrink: 0;
   color: var(--bs-light);
   opacity: 0.75;
@@ -229,6 +235,10 @@
     border-color: transparent;
     opacity: 1;
   }
+
+  @media (pointer: coarse) {
+    min-height: 2rem;
+  }
 }
 
 // Header-mounted copy button (Rouge blocks) — never overlaps code

data/_sass/custom.scss

@@ -1,3 +1,4 @@
+// Features: ZER0-001, ZER0-008, ZER0-010, ZER0-011
 // ==============================================================================
 // CUSTOM STYLES barrel — Zer0-Mistakes "custom layer"
 // ==============================================================================

data/_sass/notebooks.scss

@@ -1,3 +1,4 @@
+// Feature: ZER0-012
 // ==============================================================================
 // NOTEBOOK STYLES - Jupyter Notebook Display Styling
 // ==============================================================================

data/_sass/theme/_backgrounds.scss

@@ -1,3 +1,4 @@
+// Feature: ZER0-065
 // ==========================================================================
 // Backgrounds — fffuel-style SVG background system for zer0-mistakes theme
 // ==========================================================================
@@ -108,8 +109,12 @@
 
   // Elevate children above the ::before / ::after pseudo-element backgrounds,
   // but exclude fixed-position, offcanvas, and modal elements whose
-  // positioning must not be overridden.
-  > *:not(.fixed-top):not(.offcanvas):not(.modal) { position: relative; z-index: 1; }
+  // positioning must not be overridden. `.position-fixed` matters as much as
+  // `.fixed-top`: without it this rule (specificity 0,4,0) flattens the
+  // cookie-consent banner and the TOC FAB to z-index 1, letting the chat and
+  // local-graph FABs paint over — and steal taps from — the banner's buttons
+  // on mobile (their `--zer0-layer-*` tokens exist precisely to prevent this).
+  > *:not(.fixed-top):not(.position-fixed):not(.offcanvas):not(.modal) { position: relative; z-index: 1; }
 }
 
 .zer0-bg-surface {

data/_sass/utilities/_layout.scss

@@ -0,0 +1,11 @@
+// Feature: ZER0-077
+// =============================================================================
+// Layout utilities — small structural helpers Bootstrap does not ship
+// =============================================================================
+
+// Allow a flex child to shrink below its content size so text-truncate can
+// work (flex items default to min-width: auto). Used by the navbar leading
+// cluster, branding, and the settings panel quick-link rows.
+.min-w-0 {
+  min-width: 0 !important;
+}

data/assets/css/main.scss

@@ -22,9 +22,10 @@
 //    it so the concatenated cascade order is unchanged.
 @import "core/docs-code-examples";
 
-// 4. Reusable utilities (motion, focus rings) — used by components below
+// 4. Reusable utilities (motion, focus rings, layout helpers) — used by components below
 @import "utilities/motion";
 @import "utilities/focus";
+@import "utilities/layout";
 
 // 5. Component partials (formerly inside custom.scss + new primitives)
 @import "components/cookie-banner";

data/assets/js/ai-chat.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-060
 /**
  * ===================================================================
  * AI Chat Widget — Claude Messages API client with GitHub tool use

data/assets/js/author-profile.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-061
 /*
  * author-profile.js
  * ---------------------------------------------------------------------------

data/assets/js/auto-hide-nav.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-033
 /**
  * Auto-hide navbar on scroll with enhanced UX
  * 

data/assets/js/back-to-top.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-029
 document.addEventListener('DOMContentLoaded', () => {
   const btn = document.getElementById('backToTopBtn');
   if (!btn) return;

data/assets/js/background-customizer.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-065
 /**
  * background-customizer.js
  * Runtime switching of theme skin and fffuel-style SVG backgrounds.