jekyll-theme-zer0 0.19.0 → 0.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2762fcc15622f37d8da52c140ee11098aa163abb97e5720e97573cd7b4eef88
-  data.tar.gz: f87e1f3ccbd72c8b7d37c852310b1e47891c9704efdaa54c8aa3af5d91648881
+  metadata.gz: 19c84811dcc56b5cb437c118f6a66ce6895db10702f4011be545003bc9d6f134
+  data.tar.gz: 61f3707a93a6ac230276cb64fb007c7e2531fa23e940f9039db05fab061b99ee
 SHA512:
-  metadata.gz: 1cf89abaed77e80d6cda55622428ff5ee6c856eeed583c215d767bfcb1ed559ceb772ca1ca6c8399af7cdee106edcead83d55f94fda52771c48988d6246d54fc
-  data.tar.gz: 2dc0f873814aa9bfb9d69083ad0093bb60e49f67bfe885ed062e67b990305f6d3f13436109a9183f71d0670dcbd8d662b8555610e083a275688ec60e2065a618
+  metadata.gz: 87b0384c193e4f0ae8c75268e7a784f3c0bb90e99fdfdb4113edee8425682eb59cb9888ad8d1c28d77e4ec62c6d00e81e1f3f01d9a0e1dce278011f48cd6dfbb
+  data.tar.gz: f5bff135bbf740f16cbc0eb487568d633bffe37e5cdd5b23e33626cba98f091784c10036eababf6428f516c2618ee3956b677d8b9fde944b608d1d91947a3123

data/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## [0.20.2] - 2026-01-30
+
+### Added
+- **GitHub Pages Compatible Search**: New out-of-box search functionality that works with GitHub Pages safe mode
+  - `_includes/search-data.json` - Liquid template for generating search index
+  - `_layouts/search.html` - Layout wrapper for search.json generation
+  - Enhanced search index with `date`, `categories`, and `tags` fields
+  - Configurable content length via `site.search.content_length`
+
+### Changed
+- **search.json**: Now uses layout-based approach instead of inline Liquid for better theme integration
+- Theme users only need a 5-line `search.json` file to enable search functionality
+
+### Technical Details
+- Works in GitHub Pages safe mode (no Ruby plugins required)
+- Indexes pages, posts, and all collection documents
+- Produces valid JSON with 131+ items indexed
+- Automatically included in gem via `_includes/` and `_layouts/` directories
+
+## [0.20.1] - 2026-01-26
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 80ee1da feat(release): prepare 0.20.0
+- 8c74a60 Merge branch 'main' of https://github.com/bamr87/zer0-mistakes
+- 4d1c28c chore: update README for version 0.19.1
+- 8157508 chore(deps): update Ruby gem dependencies (#22)
+- 0f9d100 Merge branch 'main' of https://github.com/bamr87/zer0-mistakes
+- 0cf42e9 chore: update Docker image reference in CI workflow
+
+
+## [0.20.0] - 2026-01-26
+
+### Added
+- **Scaffolding templates**: New templates directory and helper scripts for fork cleanup and content setup.
+- **Testing assets**: New test helpers and configs including installation, site generation, and visual suites.
+
+### Changed
+- **CI**: Expanded workflow coverage for the updated test suite and automation paths.
+- **Install**: Enhanced installation flow for template-based setup and post-install configuration.
+- **Docs**: Updated Jekyll documentation index.
+
+### Fixed
+- **Dev build**: Exclude templates from Jekyll processing to prevent invalid date parsing.
+
+## [0.19.1] - 2026-01-25
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 516e56b fix(install): include docker/ directory in full installation
+- c8a3dbb ci: optimize CI pipeline performance and integration tests
+- 93fce7b ci: enhance CI workflow for Jekyll with improved Docker handling and site accessibility checks
+
+
 ## [0.19.0] - 2026-01-25
 
 ### Added

data/README.md

@@ -1,8 +1,8 @@
 ---
 title: zer0-mistakes
 sub-title: Jekyll Theme
-description: Docker-optimized Jekyll theme with AI-powered installation automation and comprehensive error handling.
-version: 0.16.1
+description: GitHub Pages compatible Jekyll theme with Bootstrap 5.3, featuring automated installation and comprehensive documentation.
+version: 0.19.1
 layout: landing
 tags:
   - jekyll
@@ -14,7 +14,7 @@ categories:
   - docker
   - bootstrap
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2025-11-29T00:00:00.000Z
+lastmod: 2026-01-25T00:00:00.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -23,13 +23,13 @@ keywords:
   - docker
   - remote-theme
   - github-pages
-date: 2025-11-29T12:00:00.000Z
-snippet: Docker-first Jekyll theme with remote theme support
+date: 2026-01-25T12:00:00.000Z
+snippet: GitHub Pages compatible Jekyll theme with Bootstrap 5
 comments: true
 mermaid: true
 preview: /assets/images/wizard-on-journey.png
 hero_image: /assets/images/wizard-on-journey.png
-excerpt: "Professional Jekyll theme with automated installation, comprehensive error handling, and zero-configuration Docker development"
+excerpt: "Professional Jekyll theme for GitHub Pages with Bootstrap 5.3, automated installation, and 43 documented features"
 ---
 
 [![pages-build-deployment](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment)
@@ -41,9 +41,9 @@ excerpt: "Professional Jekyll theme with automated installation, comprehensive e
 
 # 🚀 zer0-mistakes
 
-### The Self-Healing Jekyll Theme
+### GitHub Pages & Bootstrap 5 Ready
 
-**Docker-first • AI-powered • Privacy-compliant • Zero-configuration**
+**GitHub Pages compatible • Bootstrap 5.3 • Privacy-compliant • Zero-configuration**
 
 [Quick Start](#-quick-start) • [Features](#-key-features) • [Documentation](#-documentation) • [Contributing](CONTRIBUTING.md)
 
@@ -69,7 +69,7 @@ excerpt: "Professional Jekyll theme with automated installation, comprehensive e
 
 ## Overview
 
-**zer0-mistakes** is a professional Jekyll theme engineered to eliminate setup friction and provide a seamless development experience. With AI-powered error recovery, Docker containerization, and comprehensive automation, you can go from zero to deployed in under 5 minutes.
+**zer0-mistakes** is a professional Jekyll theme engineered to eliminate setup friction and provide a seamless development experience. With Docker containerization, 43 documented features, and comprehensive automation, you can go from zero to deployed in under 5 minutes.
 
 ```mermaid
 graph LR
@@ -101,7 +101,7 @@ graph LR
 | **Setup Time** | 15-30 minutes | **2-5 minutes** |
 | **Success Rate** | ~60% | **~95%** |
 | **Platform Support** | Limited | **Universal** |
-| **Error Handling** | Manual debugging | **Self-healing** |
+| **Error Handling** | Manual debugging | **Automated** |
 | **Dependencies** | Ruby + Bundler + Jekyll | **Docker only** |
 
 ---
@@ -215,14 +215,15 @@ pie title Technology Distribution
 
 | Layer | Technology | Purpose |
 |-------|-----------|---------|
-| **Framework** | Jekyll 3.10.0 | Static site generation |
+| **Framework** | Jekyll 3.9.5 | Static site generation |
 | **Styling** | Bootstrap 5.3.3 | Responsive UI components |
 | **Icons** | Bootstrap Icons | Unified iconography |
 | **Development** | Docker | Cross-platform consistency |
 | **Templates** | Liquid | Dynamic content rendering |
 | **Analytics** | PostHog | Privacy-first tracking |
 | **Diagrams** | Mermaid 10+ | Documentation visuals |
-| **Navigation** | Intersection Observer | Scroll spy & accessibility |
+| **Navigation** | ES6 Modules | Modular JavaScript architecture |
+| **Search** | Client-side JSON | Fast in-browser search |
 
 ---
 
@@ -230,7 +231,7 @@ pie title Technology Distribution
 
 ### 🤖 AI-Powered Installation
 
-The 1,090-line `install.sh` script provides intelligent error recovery with 27+ automated fix scenarios:
+The ~1,100-line `install.sh` script provides intelligent platform detection and Docker configuration:
 
 ```mermaid
 flowchart TD
@@ -238,21 +239,16 @@ flowchart TD
     DETECT --> CHECK{Prerequisites OK?}
     
     CHECK -->|Yes| DOWNLOAD[Download Theme]
-    CHECK -->|No| FIX[Auto-Fix Issues]
-    FIX --> CHECK
+    CHECK -->|No| GUIDE[Show Requirements]
     
     DOWNLOAD --> CONFIG[Configure Docker]
     CONFIG --> VALIDATE{Build Success?}
     
     VALIDATE -->|Yes| DONE([✅ Ready!])
-    VALIDATE -->|No| DIAGNOSE[Diagnose Error]
-    DIAGNOSE --> RECOVER[Apply Fix]
-    RECOVER --> VALIDATE
+    VALIDATE -->|No| LOGS[Show Error Logs]
     
     style START fill:#e3f2fd
     style DONE fill:#c8e6c9
-    style FIX fill:#fff3e0
-    style RECOVER fill:#fff3e0
 ```
 
 ### 🐳 Docker-First Development
@@ -332,17 +328,18 @@ collections:
     permalink: /notebooks/:name/
 ```
 
-### 🧭 Enhanced Navigation System (v0.14.0)
+### 🧭 Enhanced Navigation System (v0.17.0)
 
-Modern, accessible sidebar navigation with advanced features:
+Modern, accessible sidebar navigation with ES6 modular architecture:
 
+- **ES6 Navigation Modules**: Modular JavaScript with native ES6 imports
+- **Navbar Hover Dropdowns**: Desktop hover support with smooth fade transitions
 - **Intersection Observer Scroll Spy**: 70% reduction in scroll event overhead
 - **Keyboard Shortcuts**: `[` and `]` for section navigation
 - **Swipe Gestures**: Mobile-friendly left/right edge detection
 - **Skip-to-Content**: Accessibility-first WCAG 2.1 Level AA compliant
 - **Mobile TOC FAB**: Floating action button for table of contents
-- **Unified Bootstrap Icons**: Consistent iconography across all components
-- **Focus Management**: Improved screen reader support with ARIA labels
+- **Nav Tree Component**: Hierarchical YAML navigation rendering
 
 | Shortcut | Action |
 |----------|--------|
@@ -351,6 +348,30 @@ Modern, accessible sidebar navigation with advanced features:
 | `Tab` | Skip to content |
 | Swipe | Toggle sidebar (mobile) |
 
+### 🔍 Site Search (v0.18.0)
+
+Client-side search with modal interface and keyboard shortcuts:
+
+- **Keyboard Activation**: Press `/` or `Cmd/Ctrl+K` to open search
+- **Real-time Results**: Instant search across all content
+- **JSON Index**: Auto-generated search index for fast queries
+- **Bootstrap Modal**: Responsive modal interface
+
+| Shortcut | Action |
+|----------|--------|
+| `/` | Open search modal |
+| `Cmd/Ctrl+K` | Open search modal |
+| `Escape` | Close search |
+
+### 🎨 Dark/Light Mode Toggle
+
+Theme color mode switcher with system preference detection:
+
+- **Three Modes**: Light, dark, and auto (system preference)
+- **Persistence**: LocalStorage saves user preference
+- **Smooth Transitions**: CSS transitions between themes
+- **Bootstrap Integration**: Uses `data-bs-theme` attribute
+
 ### 📋 Legal & Compliance Pages (v0.15.0)
 
 Built-in GDPR/CCPA compliant documentation:
@@ -390,7 +411,7 @@ docker-compose up
 
 ```ruby
 # Gemfile
-gem "jekyll-theme-zer0", "~> 0.15"
+gem "jekyll-theme-zer0", "~> 0.19"
 ```
 
 ---
@@ -566,8 +587,9 @@ graph LR
 |----------|-------------|
 | [📋 Technical Docs]({{ site.resources.github_repo | default: '' | join: '' }}/tree/{{ site.branch }}/docs/) | Architecture, systems, implementation |
 | [📖 User Guides]({{ '/docs/' | relative_url }}) | Published tutorials and references |
-| [🤖 Copilot Instructions]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/.github/copilot-instructions.md) | AI development guidelines |
-| [⌨️ Keyboard Navigation]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/docs/keyboard-navigation.md) | Accessibility shortcuts guide |
+| [🎨 Customization]({{ '/docs/customization/' | relative_url }}) | Layouts, styles, navigation guides |
+| [📊 Analytics]({{ '/docs/analytics/' | relative_url }}) | PostHog, Google Analytics setup |
+| [🔍 SEO]({{ '/docs/seo/' | relative_url }}) | Meta tags, sitemap, structured data |
 | [📓 Jupyter Notebooks]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
 | [📝 PRD](docs/PRD.md) | Product requirements & roadmap |
 | [🔒 Privacy Policy]({{ '/privacy-policy/' | relative_url }}) | GDPR/CCPA compliant privacy docs |
@@ -614,9 +636,9 @@ flowchart LR
 /opt/homebrew/bin/bash scripts/release patch --dry-run
 
 # Full release
-/opt/homebrew/bin/bash scripts/release patch  # 0.15.0 → 0.15.1
-/opt/homebrew/bin/bash scripts/release minor  # 0.15.0 → 0.16.0
-/opt/homebrew/bin/bash scripts/release major  # 0.15.0 → 1.0.0
+/opt/homebrew/bin/bash scripts/release patch  # 0.19.1 → 0.19.2
+/opt/homebrew/bin/bash scripts/release minor  # 0.19.1 → 0.20.0
+/opt/homebrew/bin/bash scripts/release major  # 0.19.1 → 1.0.0
 ```
 
 ---
@@ -627,20 +649,23 @@ flowchart LR
 gantt
     title zer0-mistakes Roadmap
     dateFormat YYYY-MM
+    section Completed
+    v0.17 ES6 Navigation      :done, 2025-12, 2025-12
+    v0.18 Site Search         :done, 2026-01, 2026-01
+    v0.19 Feature Discovery   :done, 2026-01, 2026-01
     section Current
-    v0.15.x Maintenance       :done, 2025-12, 2026-01
+    v0.19.x Maintenance       :active, 2026-01, 2026-02
     section Future
-    v0.16 - CMS Integration   :2026-01, 2026-03
-    v0.17 - Advanced Analytics:2026-04, 2026-06
-    v0.18 - i18n Support      :2026-07, 2026-09
-    v1.0 - Production Ready   :milestone, 2027-01, 1d
+    v0.20 CMS Integration     :2026-02, 2026-04
+    v0.21 i18n Support        :2026-05, 2026-07
+    v1.0 Production Ready     :milestone, 2027-01, 1d
 ```
 
 | Version | Target | Features |
 |---------|--------|----------|
-| **v0.16** | Q1 2026 | Headless CMS integration, content API |
-| **v0.17** | Q2 2026 | A/B testing, conversion funnels |
-| **v0.18** | Q3 2026 | Multi-language support (i18n) |
+| **v0.19** | Current | 43 documented features, comprehensive documentation |
+| **v0.20** | Q1 2026 | Headless CMS integration, content API |
+| **v0.21** | Q2 2026 | Multi-language support (i18n) |
 | **v1.0** | Q1 2027 | Stable API, 90%+ test coverage |
 
 ---
@@ -696,11 +721,11 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 0.15.0 |
-| **Installation Success** | ~95% |
+| **Current Version** | 0.19.1 |
+| **Documented Features** | 43 |
 | **Setup Time** | 2-5 minutes |
+| **Documentation Pages** | 70+ |
 | **RubyGems Downloads** | 3,000+ |
-| **Documentation** | 20,000+ lines |
 | **Lighthouse Score** | 95+ |
 
 ---
@@ -720,6 +745,6 @@ Built with these amazing technologies:
 
 **Built with ❤️ for the Jekyll community**
 
-**v0.15.0** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
+**v0.19.1** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
 
 

data/_includes/search-data.json

@@ -0,0 +1,27 @@
+[
+{%- assign search_pages = site.pages | where_exp: "item", "item.title" -%}
+{%- assign search_posts = site.posts -%}
+{%- assign search_docs = site.documents -%}
+{%- assign search_items = search_pages | concat: search_posts | concat: search_docs -%}
+{%- assign content_limit = site.search.content_length | default: 1000 -%}
+{%- assign first = true -%}
+{%- for item in search_items -%}
+    {%- if item.url and item.title -%}
+        {%- if item.url contains '/assets/' or item.url == '/search.json' -%}
+            {%- continue -%}
+        {%- endif -%}
+        {%- unless first -%},{%- endunless -%}
+        {
+            "title": {{ item.title | strip_newlines | jsonify }},
+            "url": {{ item.url | relative_url | jsonify }},
+            "description": {{ item.description | default: item.excerpt | default: "" | strip_html | strip_newlines | jsonify }},
+            "content": {{ item.content | strip_html | strip_newlines | truncate: content_limit | jsonify }},
+            "collection": {{ item.collection | default: "pages" | jsonify }},
+            "date": {{ item.date | date: "%Y-%m-%d" | jsonify }},
+            "categories": {{ item.categories | default: empty | jsonify }},
+            "tags": {{ item.tags | default: empty | jsonify }}
+        }
+        {%- assign first = false -%}
+    {%- endif -%}
+{%- endfor -%}
+]

data/_layouts/search.html

@@ -0,0 +1 @@
+{% include search-data.json %}