jekyll-theme-zer0 0.16.0 → 0.17.2

data/_data/navigation/README.md

@@ -0,0 +1,54 @@
+# Navigation Data Schema Documentation
+# ===================================
+#
+# This directory contains YAML navigation data files used by the sidebar
+# and navbar components. All files follow a standardized schema.
+#
+# ## Schema Definition
+#
+# Each navigation item can have the following properties:
+#
+# ```yaml
+# - title: string        # Required - Display text
+#   url: string          # Optional - Link URL (relative to site root)
+#   icon: string         # Optional - Bootstrap Icons class (e.g., "bi-folder")
+#   description: string  # Optional - Tooltip or description text
+#   expanded: boolean    # Optional - Default expanded state (default: false)
+#   children: array      # Optional - Nested navigation items (recursive)
+# ```
+#
+# ## Navigation Modes
+#
+# The sidebar supports three navigation modes set via `page.sidebar.nav`:
+#
+# 1. **auto** - Auto-generates from collection documents
+# 2. **tree** - Uses YAML data from this directory
+# 3. **categories** - Groups by Jekyll categories
+#
+# ## Available Files
+#
+# - main.yml      - Primary site navigation (navbar)
+# - docs.yml      - Documentation section navigation
+# - about.yml     - About section navigation
+# - quickstart.yml - Quick start guide navigation
+# - home.yml      - Homepage quick links
+# - posts.yml     - Blog category navigation
+#
+# ## Example Usage
+#
+# In page front matter:
+# ```yaml
+# sidebar:
+#   nav: docs  # Uses _data/navigation/docs.yml
+# ```
+#
+# ## Schema Validation
+#
+# Navigation YAML is validated at build time by _plugins/navigation_validator.rb
+# Invalid schemas will produce build warnings.
+#
+# ## Migration Notes (v2.0)
+#
+# - Renamed `sublinks` to `children` for consistency with tree terminology
+# - Added `expanded` property for default state
+# - Navigation modes changed: dynamic→auto, searchCats→categories

data/_data/navigation/about.yml

@@ -1,11 +1,13 @@
 # About Navigation Configuration
-# Used by: About section sidebar and related pages
+# Used by: About section sidebar (nav: tree)
 # Purpose: Navigation for about pages, features, settings, and site info
+# Schema: See README.md for full documentation
 
 - title: About
   icon: bi-info-circle
   url: /about/
-  sublinks:
+  expanded: true
+  children:
     - title: Overview
       url: /about/
     - title: Features
@@ -16,7 +18,7 @@
 - title: Site Info
   icon: bi-bar-chart
   url: /about/stats/
-  sublinks:
+  children:
     - title: Statistics
       url: /about/stats/
     - title: Site Map
@@ -27,14 +29,14 @@
 - title: Settings
   icon: bi-gear
   url: /about/config/
-  sublinks:
+  children:
     - title: Configuration
       url: /about/config/
 
 - title: Legal
   icon: bi-file-text
   url: /terms-of-service/
-  sublinks:
+  children:
     - title: Terms of Service
       url: /terms-of-service/
     - title: Privacy Policy

data/_data/navigation/docs.yml

@@ -1,57 +1,103 @@
 # Documentation Navigation Configuration
-# Used by: Docs sidebar and documentation pages
-# Purpose: Organize documentation by topic area
+# Used by: Docs sidebar (nav: tree)
+# Purpose: Organize documentation by topic area for _docs collection
+# Schema: See README.md for full documentation
 
+# ============================================================
+# Getting Started
+# ============================================================
+- title: Getting Started
+  icon: bi-rocket-takeoff
+  url: /docs/
+  expanded: true
+  children:
+    - title: Documentation Home
+      url: /docs/
+    - title: Installation
+      url: /docs/installation/
+    - title: Troubleshooting
+      url: /docs/troubleshooting/
+
+# ============================================================
+# Core Technologies
+# ============================================================
 - title: Jekyll
   icon: bi-journal-code
   url: /docs/jekyll/
-  sublinks:
-    - title: Jekyll Guide
+  children:
+    - title: Jekyll Overview
       url: /docs/jekyll/
-    - title: Mermaid Diagrams
-      url: /docs/jekyll/mermaid-native-markdown/
-    - title: Math with MathJax
-      url: /docs/jekyll/jekyll-math-symbols-with-mathjax/
+    - title: Configuration
+      url: /docs/jekyll/jekyll-config/
+    - title: Front Matter
+      url: /docs/front-matter/
     - title: Liquid Templating
       url: /docs/jekyll/jekyll-liquid/
-    - title: Frontmatter CMS
-      url: /docs/jekyll/jekyll-frontmatter-cms/
     - title: Syntax Highlighting
       url: /docs/jekyll/jekyll-highlighting/
+    - title: Performance
+      url: /docs/jekyll/jekyll-performance-optimization/
+    - title: Security
+      url: /docs/jekyll/jekyll-security/
+
+- title: Ruby & Bundler
+  icon: bi-gem
+  url: /docs/ruby/
+  children:
+    - title: Ruby Overview
+      url: /docs/ruby/
+    - title: Ruby 101
+      url: /docs/ruby-101/
+
+- title: Liquid
+  icon: bi-droplet
+  url: /docs/liquid/
+  children:
+    - title: Liquid Overview
+      url: /docs/liquid/
 
+- title: Docker
+  icon: bi-box-seam
+  url: /docs/docker/
+  children:
+    - title: Docker Overview
+      url: /docs/docker/
+
+- title: Bootstrap
+  icon: bi-bootstrap
+  url: /docs/bootstrap/
+  children:
+    - title: Bootstrap Overview
+      url: /docs/bootstrap/
+
+# ============================================================
+# Theme Features
+# ============================================================
 - title: Features
   icon: bi-stars
-  url: /about/features/
-  sublinks:
+  url: /features/
+  children:
     - title: All Features
-      url: /about/features/
+      url: /features/
+    - title: Mermaid Diagrams
+      url: /docs/jekyll/mermaid-native-markdown/
+    - title: Math with MathJax
+      url: /docs/jekyll/jekyll-math-symbols-with-mathjax/
     - title: Preview Image Generator
       url: /docs/features/preview-image-generator/
-    - title: Statistics Dashboard
-      url: /about/features/statistics-dashboard/
-    - title: AI Development Guide
-      url: /about/features/ai-development-guide/
+    - title: Frontmatter CMS
+      url: /docs/jekyll/jekyll-frontmatter-cms/
 
+# ============================================================
+# Deployment
+# ============================================================
 - title: Deployment
   icon: bi-cloud-upload
   url: /quickstart/github-setup/
-  sublinks:
+  children:
     - title: GitHub Pages
       url: /quickstart/github-setup/
     - title: Netlify
       url: /docs/jekyll/deploying-jekyll-website-to-netlify/
     - title: Custom Domain
       url: /docs/jekyll/deploying-personal-website-with-custom-domain/
-
-- title: Configuration
-  icon: bi-gear
-  url: /about/config/
-  sublinks:
-    - title: Site Config
-      url: /about/config/
-    - title: Jekyll Config
-      url: /docs/jekyll/jekyll-config/
-    - title: Performance
-      url: /docs/jekyll/jekyll-performance-optimization/
-    - title: Security
-      url: /docs/jekyll/jekyll-security/

data/_data/navigation/home.yml

@@ -1,11 +1,12 @@
 # Home Navigation Configuration
 # Used by: Header navigation and homepage quick links
 # Purpose: Quick access links for the home/landing area
+# Schema: See README.md for full documentation
 
 - title: Home
   icon: bi-house
   url: /
-  sublinks:
+  children:
     - title: Blog
       url: /blog/
     - title: Quick Start
@@ -14,7 +15,7 @@
 - title: Discover
   icon: bi-compass
   url: /sitemap/
-  sublinks:
+  children:
     - title: Site Map
       url: /sitemap/
     - title: Categories
@@ -25,7 +26,7 @@
 - title: Connect
   icon: bi-envelope
   url: /contact/
-  sublinks:
+  children:
     - title: Contact
       url: /contact/
     - title: About

data/_data/navigation/main.yml

@@ -1,11 +1,12 @@
 # Main Navigation Configuration
 # Used by: _includes/navigation/navbar.html
-# Purpose: Primary site navigation with dropdown sublinks
+# Purpose: Primary site navigation with dropdown children
+# Schema: See README.md for full documentation
 
 - title: Quick Start
   icon: bi-rocket-takeoff
   url: /quickstart/
-  sublinks:
+  children:
     - title: Machine Setup
       url: /quickstart/machine-setup/
     - title: Jekyll Setup
@@ -16,7 +17,7 @@
 - title: Blog
   icon: bi-journal-text
   url: /blog/
-  sublinks:
+  children:
     - title: All Posts
       url: /posts/
     - title: Categories
@@ -27,18 +28,26 @@
 - title: Docs
   icon: bi-journal-bookmark
   url: /docs/
-  sublinks:
+  children:
+    - title: Documentation Home
+      url: /docs/
+    - title: Installation
+      url: /docs/installation/
     - title: Jekyll Guide
       url: /docs/jekyll/
+    - title: Docker
+      url: /docs/docker/
     - title: Features
-      url: /about/features/
+      url: /features/
+    - title: Troubleshooting
+      url: /docs/troubleshooting/
 
 - title: About
   icon: bi-info-circle
   url: /about/
-  sublinks:
+  children:
     - title: Features
-      url: /about/features/
+      url: /features/
     - title: Statistics
       url: /about/stats/
     - title: Config

data/_data/navigation/quickstart.yml

@@ -1,12 +1,14 @@
 # Quick Start Navigation Configuration
-# Used by: Quick Start sidebar and related pages
+# Used by: Quick Start sidebar (nav: tree)
 # Purpose: Step-by-step guide navigation for new users
 # Order: Overview → Machine → Jekyll → GitHub → Personalization
+# Schema: See README.md for full documentation
 
 - title: "Quick Start"
   icon: bi-flag
   url: /quickstart/
-  sublinks:
+  expanded: true
+  children:
     - title: "1. Machine Setup"
       url: /quickstart/machine-setup/
       icon: bi-laptop

data/_includes/components/cookie-consent.html

@@ -49,7 +49,7 @@ Usage: Include in root.html layout
 Configuration: Uses site.posthog settings from _config.yml
 {% endcomment %}
 
-<div id="cookieConsent" class="cookie-consent-banner position-fixed bottom-0 start-0 end-0 bg-dark text-light p-3 shadow-lg" style="z-index: 9999; transform: translateY(100%); transition: transform 0.3s ease-in-out;">
+<div id="cookieConsent" class="cookie-consent-banner position-fixed bottom-0 start-0 end-0 bg-dark text-light p-3 shadow-lg">
   <div class="container-fluid">
     <div class="row align-items-center">
       <div class="col-12 col-lg-8">
@@ -248,18 +248,42 @@ Configuration: Uses site.posthog settings from _config.yml
     // Show consent banner
     function showConsentBanner() {
       const banner = document.getElementById('cookieConsent');
-      if (banner) {
-        setTimeout(() => {
-          banner.style.transform = 'translateY(0)';
-        }, 1000); // Show after 1 second
-      }
+      if (!banner) return;
+      
+      // Ensure banner starts completely hidden - remove all classes and inline styles
+      banner.classList.remove('cookie-banner-showing', 'cookie-banner-visible');
+      banner.removeAttribute('style'); // Remove all inline styles to let CSS take over
+      
+      // Wait for the delay, then show and animate in one smooth motion
+      setTimeout(() => {
+        // First, make it visible but still off-screen (using class for CSS control)
+        banner.classList.add('cookie-banner-showing');
+        
+        // Force a reflow to ensure the display change is applied
+        void banner.offsetHeight;
+        
+        // On the next frame, animate it in smoothly
+        requestAnimationFrame(() => {
+          requestAnimationFrame(() => {
+            banner.classList.add('cookie-banner-visible');
+          });
+        });
+      }, 1000); // Show after 1 second
     }
 
     // Hide consent banner
     function hideConsentBanner() {
       const banner = document.getElementById('cookieConsent');
       if (banner) {
-        banner.style.transform = 'translateY(100%)';
+        // Remove visible class to trigger transition out
+        banner.classList.remove('cookie-banner-visible');
+        
+        // Hide after transition completes
+        banner.addEventListener('transitionend', function hideAfterTransition() {
+          banner.classList.remove('cookie-banner-showing');
+          banner.removeAttribute('style'); // Clean up inline styles
+          banner.removeEventListener('transitionend', hideAfterTransition);
+        }, { once: true });
       }
     }
 
@@ -281,14 +305,27 @@ Configuration: Uses site.posthog settings from _config.yml
 
     // Initialize on DOM content loaded
     document.addEventListener('DOMContentLoaded', function() {
+      const banner = document.getElementById('cookieConsent');
+      
+      // Ensure banner starts completely hidden BEFORE any checks
+      // Remove all classes and inline styles - let CSS handle hiding
+      if (banner) {
+        banner.classList.remove('cookie-banner-showing', 'cookie-banner-visible');
+        banner.removeAttribute('style');
+      }
+      
       const existingConsent = getConsentState();
       
       if (existingConsent) {
-        // Apply existing consent
+        // Apply existing consent and ensure banner stays hidden
         applyConsent(existingConsent);
         updateModalUI(existingConsent);
+        if (banner) {
+          banner.classList.remove('cookie-banner-showing', 'cookie-banner-visible');
+          banner.removeAttribute('style');
+        }
       } else {
-        // Show consent banner for new visitors
+        // Show consent banner for new visitors (with delay)
         showConsentBanner();
       }
 
@@ -348,12 +385,40 @@ Configuration: Uses site.posthog settings from _config.yml
 </script>
 
 <style>
+  /* Banner base styles */
+  #cookieConsent {
+    z-index: 9999;
+    transition: transform 0.4s cubic-bezier(0.4, 0, 0.2, 1), opacity 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+  
+  /* Banner starts completely hidden - CSS enforces this */
+  #cookieConsent:not(.cookie-banner-showing) {
+    display: none !important;
+    visibility: hidden !important;
+    opacity: 0 !important;
+    transform: translateY(100%) !important;
+  }
+  
   .cookie-consent-banner {
     background: linear-gradient(135deg, #2c3e50 0%, #3498db 100%);
     backdrop-filter: blur(10px);
     border-top: 1px solid rgba(255, 255, 255, 0.1);
   }
   
+  /* Only show banner when explicitly enabled via JavaScript class */
+  #cookieConsent.cookie-banner-showing {
+    display: block !important;
+    visibility: visible !important;
+    opacity: 0;
+    transform: translateY(100%);
+  }
+  
+  /* Animate in when visible class is added */
+  #cookieConsent.cookie-banner-showing.cookie-banner-visible {
+    opacity: 1 !important;
+    transform: translateY(0) !important;
+  }
+  
   .cursor-pointer {
     cursor: pointer;
   }
@@ -379,4 +444,11 @@ Configuration: Uses site.posthog settings from _config.yml
       margin-bottom: 0;
     }
   }
+  
+  /* Respect reduced motion preferences */
+  @media (prefers-reduced-motion: reduce) {
+    .cookie-consent-banner {
+      transition: none !important;
+    }
+  }
 </style>

data/_includes/components/js-cdn.html

@@ -28,5 +28,5 @@
         integrity="sha384-YvpcrYf0tY3lHB60NNkmXc5s9fDVZLESaAA55NDzOxhy9GkcIdslK1eN7N6jIeHz" 
         crossorigin="anonymous"></script>
 
-<!-- Sidebar Navigation Enhancements - Deferred for performance -->
-<script defer src="{{ '/assets/js/sidebar.js' | relative_url }}"></script>
+<!-- Navigation ES6 Modules - Enhanced sidebar, scroll spy, keyboard shortcuts, gestures -->
+<script type="module" src="{{ '/assets/js/modules/navigation/index.js' | relative_url }}"></script>