jekyll-theme-zer0 0.10.6 → 0.15.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3eeba0bbdc165f553bcbf3f7f2b014336e1894f6cff75acf7e37c9583fb3cc82
-  data.tar.gz: 5daa6b3832331353b87c1deec07580bb4a7864982efb4987afbfd9d65111dd8e
+  metadata.gz: 62704de5aed76c7000c418b93977002ded56b588a49183c4548c315bd2b40fdd
+  data.tar.gz: acfd3a0d47a33a99af964fe2019e0128bbfb50903640658671bb6090b3b38495
 SHA512:
-  metadata.gz: acbe6651ea5f84e38430e4688fa26a6cbc957cabf1b1cde37d1b1e8f96662e47585654c7d5e2a85486c1ed6cb110134eb4c0d71028b4bb038b0d21784709c5fc
-  data.tar.gz: a97c013488173951e4d44359594d48f1529c1909668a4d2657136d4e48be5d7b693fff305daf87e44db93440a9efffb6dfeb6c2b71dd7e6298f2d79c50dfc393
+  metadata.gz: 8db972fbd75ed902880434ab1e8a79ba24ae276492cebce8987cda3ad085b0aeea26fc2174e8cf72594896884c5d1b3b08f816b97a0d1536044d51afa52c2d5e
+  data.tar.gz: 839bbeb76675da98c6136c952722154249264fe4998003b4c5e2152401855dcea16ac31864f89e66a30236589e41ecc789361378fd3308a8c529cd8315c67a0f

data/CHANGELOG.md

@@ -1,5 +1,433 @@
 # Changelog
 
+## [0.15.2] - 2025-12-19
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- e1342ab Add configuration files for content organization, prerequisites, statistics, and UI text
+- 366e8a2 chore(deps): update Ruby gem dependencies (#16)
+
+
+## [0.15.1] - 2025-12-14
+
+### Changed
+-  update test runner documentation for Bash 3.2 compatibility
+-  update version to 0.15.0 and enhance documentation with new features
+
+### Fixed
+-  refactor changelog.sh for Bash 3.2 compatibility (macOS default)
+
+### Other
+-  document Bash 3.2 compatibility in automation
+-  unfreeze bundler before updating Gemfile.lock in version-bump workflow
+-  update Windows Developer Mode instructions and correct spelling errors
+-  Social sharing buttons use production URLs instead of localhost
+-  update Gemfile.lock for v0.15.0
+
+
+
+## [0.15.0] - 2025-12-11
+
+### Added
+
+- **Documentation: Product Requirements Document** - Comprehensive PRD detailing product vision, goals, and architecture
+  - Added `docs/PRD.md` with complete product specifications
+  - Includes vision statement, key differentiators, and metrics
+  - Documents AI-powered features and privacy-first principles
+  
+- **Documentation: Sidebar Improvements Summary** - Complete implementation documentation for sidebar enhancements
+  - Added `docs/SIDEBAR_IMPROVEMENTS.md` documenting UI/UX modernization
+  - Details scroll spy fixes, mobile TOC button positioning
+  - Documents responsive design improvements and accessibility features
+  
+- **Documentation: Theme Version Implementation** - Theme version display system documentation
+  - Added `docs/THEME_VERSION_IMPLEMENTATION.md` 
+  - Documents automatic version extraction from gem specification
+  - Explains modal integration and footer access points
+  
+- **Content: Privacy Policy Page** - GDPR/CCPA compliant privacy policy
+  - Added `pages/privacy-policy.md` with comprehensive privacy documentation
+  - Details PostHog analytics data collection practices
+  - Explains user rights and data protection measures
+  
+- **Content: Terms of Service Page** - Legal terms for site usage
+  - Added `pages/terms-of-service.md` 
+  - Provides basic terms framework for site operators
+  
+- **Testing: Notebook Conversion Test Script** - Automated testing for Jupyter notebook conversion
+  - Added `test/test-notebook-conversion.sh` for notebook workflow testing
+  - Validates Python/nbconvert installation in Docker
+  - Tests notebook listing and conversion processes
+
+### Documentation
+
+- All new files are fully documented with appropriate frontmatter
+- Privacy policy provides transparency for analytics usage
+- PRD serves as single source of truth for product direction
+
+## [0.14.2] - 2025-12-07
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 82d7441 fix(build): improve gem info retrieval error handling
+- 67a8e5b fix(ci): remove Ruby 3.0 from test matrix
+- afe057d chore(deps): update Ruby gem dependencies (#11)
+- 64ee1c9 fix(ci): add proper permissions for PR creation
+- 3b55b60 feat(ci): add automated dependency update workflow
+- a3197b3 fix(deps): commit Gemfile.lock for reproducible builds
+- d8188dd fix(docker): install bundler 2.3 to match Gemfile.lock requirement
+- 04d7c26 fix(docker): remove bundle update --bundler that requires existing bundle
+
+
+## [0.14.1] - 2025-12-04
+
+### Fixed
+
+- **Docker: Bundler Version Compatibility** - Resolved CI/CD build failure
+  - Added `bundle update --bundler` step in Dockerfile to auto-update lockfile
+  - Allows using latest Bundler (4.0.0) while maintaining dependency stability
+  - Preserves all gem versions from `Gemfile.lock`
+  - Aligns with project's "zero version pin" philosophy
+  - Fixes GitHub Actions "Build (Latest Deps)" workflow failure
+
+## [0.14.0] - 2025-12-01
+
+### Added
+
+- **Navigation: Enhanced Sidebar System** - Complete overhaul of sidebar navigation with modern features
+  - New `assets/js/sidebar.js` (16KB) with Intersection Observer scroll spy
+  - Smooth scrolling to TOC anchors with fixed header offset
+  - Keyboard shortcuts: `[` and `]` for section navigation
+  - Swipe gestures for mobile (left/right edge detection)
+  - Focus management for accessibility
+  - `docs/keyboard-navigation.md` - Complete keyboard navigation documentation
+
+- **Navigation: Skip-to-Content Link** - Accessibility enhancement in header
+  - Visually hidden until focused with Tab key
+  - Direct jump to main content bypassing navigation
+  - WCAG 2.1 Level AA compliant
+
+- **Mobile: TOC Floating Action Button** - Improved mobile table of contents access
+  - Repositioned from center-right to bottom-right (90px from bottom)
+  - FAB pattern with 56x56px circular button
+  - Proper stacking above back-to-top button
+  - z-index: 1030 for proper layering
+
+### Changed
+
+- **Navigation: Unified Bootstrap Icons** - Standardized icon library across all sidebars
+  - Replaced Font Awesome (`fas fa-file-alt`) with Bootstrap Icons (`bi-file-text`)
+  - Consistent icon sizing and spacing (me-2 margin)
+  - Icons: `bi-folder2-open`, `bi-folder`, `bi-file-earmark-text`, `bi-list-ul`
+
+- **Navigation: Scroll Spy Fix** - Corrected scroll tracking in default layout
+  - Fixed `data-bs-target` from `toc-content` to `#TableOfContents`
+  - Added `data-bs-smooth-scroll="true"` for better UX
+  - Added `data-bs-offset="100"` for fixed header compensation
+
+- **Navigation: Responsive Sidebar Widths** - Removed hardcoded widths for better responsiveness
+  - `sidebar-categories.html`: Changed from `width: 280px` to `w-100`
+  - Uses Bootstrap grid system for fluid layouts
+  - Improved mobile and tablet compatibility
+
+- **Styles: Unified Sidebar Classes** - Consolidated duplicate CSS definitions
+  - Removed duplicate `.sidebar` class from `custom.scss`
+  - Kept only `.bd-sidebar` in `_docs.scss` for consistency
+  - Uncommented z-index (2) for proper TOC stacking
+
+- **Styles: Enhanced Active States** - Improved visual feedback for navigation
+  - Active TOC links: 600 font-weight, subtle background highlight
+  - Category active state: Primary color with background tint
+  - Sidebar hover states: Smooth 0.2s transitions
+  - Mobile TOC button: Scale transforms on hover/active
+
+- **JavaScript: Deferred Loading** - Optimized script loading for better performance
+  - Added `defer` attribute to `sidebar.js`
+  - Prevents blocking and scroll event conflicts
+  - Fixed auto-hide navbar functionality
+  - Parallel download with in-order execution
+
+- **Accessibility: ARIA Enhancements** - Improved screen reader support
+  - Added `role="navigation"` and `aria-label` to TOC
+  - Added `aria-controls` to all collapse/offcanvas buttons
+  - Improved button accessibility with descriptive labels
+  - Better focus management in offcanvas panels
+
+### Fixed
+
+- **Critical: Scroll Spy Not Working** - Resolved selector mismatch in default layout
+  - Corrected target from `toc-content` to `#TableOfContents`
+  - Active section now properly highlights in TOC
+  - Smooth scroll with proper offset for fixed headers
+
+- **Critical: Mobile Button Conflict** - Fixed TOC and back-to-top button overlap
+  - TOC button: moved to `bottom: 90px` from `bottom: 0`
+  - Back-to-top button: updated z-index to 1020
+  - 14px vertical spacing between buttons
+  - No more overlapping on mobile devices
+
+- **Critical: Auto-Hide Navbar Broken** - Fixed navbar hiding on scroll
+  - Added `defer` attribute to `sidebar.js` script tag
+  - Resolved scroll event listener conflicts
+  - Both scripts now use requestAnimationFrame optimization
+  - Navbar properly hides/shows on scroll
+
+- **UI: Icon Library Inconsistency** - Unified icon usage across components
+  - Eliminated mixed Font Awesome and Bootstrap Icons usage
+  - All components now use Bootstrap Icons exclusively
+  - Consistent visual language throughout theme
+
+### Performance
+
+- **Intersection Observer Scroll Spy** - 70% reduction in scroll event overhead
+  - Replaced scroll events with Intersection Observer API
+  - Configurable root margins and thresholds
+  - Auto-scrolling TOC to show active link
+  - Debounced event handlers (100ms delay)
+
+- **Passive Scroll Listeners** - Improved scrolling performance
+  - All scroll events use `{ passive: true }` option
+  - Prevents scroll jank and layout thrashing
+  - Better frame rates on mobile devices
+
+### Documentation
+
+- **Guide: Keyboard Navigation** - Comprehensive accessibility documentation
+  - Complete shortcut reference table
+  - Skip navigation instructions
+  - Focus management guidelines
+  - Browser compatibility matrix
+  - Troubleshooting section
+
+- **Technical: Implementation Summary** - Development documentation
+  - `SIDEBAR_IMPROVEMENTS.md` with complete implementation details
+  - Architecture decisions and patterns
+  - Testing checklist and verification steps
+  - Future enhancement roadmap
+
+## [0.13.0] - 2025-12-01
+
+### Added
+
+- **Navigation: Bootstrap Icons** - Added icons to all main navigation items
+  - Quick Start: `bi-rocket-takeoff`
+  - Blog: `bi-journal-text`
+  - Docs: `bi-journal-bookmark`
+  - About: `bi-info-circle`
+
+- **Navigation: New Links** - Enhanced navigation structure with additional pages
+  - Categories page (`/categories/`)
+  - Tags page (`/tags/`)
+  - Contact page (`/contact/`)
+  - Features page (`/about/features/`)
+  - Statistics page (`/about/stats/`)
+
+- **Frontmatter CMS: Navigation Data Type** - Enhanced data schema for navigation management
+  - Added optional `description` field for parent and child links
+  - Added optional `icon` field for sublinks
+  - Registered all 6 navigation files (main, quickstart, about, docs, posts, home)
+  - Improved schema validation with proper required fields
+
+### Changed
+
+- **Navigation: Restructured All Files** - Aligned navigation with actual site content
+  - `main.yml` - Updated Quick Start, Blog, Docs, and About sections
+  - `quickstart.yml` - Added icons to setup steps
+  - `docs.yml` - Reorganized into Jekyll, Features, Deployment, Configuration sections
+  - `about.yml` - Structured into About, Site Info, Settings, Legal sections
+  - `posts.yml` - Fixed icon prefixes (added `bi-`), added descriptions
+  - `home.yml` - Added Discover and Connect navigation groups
+
+- **Frontmatter: Website Configuration** - Updated preview and website hosts
+  - Changed preview host from `localhost:4002` to `localhost:4000`
+  - Changed website host from `it-journey.dev` to `zer0-mistakes.com`
+
+### Removed
+
+- **Navigation: Dead Link** - Removed orphaned `/zer0/` link from Quick Start menu
+- **Navigation: Unused Entry** - Removed Theme page link (replaced with Features)
+
+### Fixed
+
+- **Navigation: Icon Consistency** - Standardized Bootstrap icon class format across all files
+- **Navigation: URL Completeness** - Ensured all top-level navigation items have required URL field
+
+## [0.12.1] - 2025-11-30
+
+### Changed
+
+- **Refactored: Scripts Directory Structure** - Consolidated and organized automation scripts
+  - Entry point scripts (`build`, `release`) in `scripts/` are now thin wrappers to `scripts/bin/`
+  - Test scripts (`test.sh`, `test-auto-version.sh`, `test-mermaid.sh`) forward to `scripts/test/`
+  - Utility scripts (`setup.sh`, `analyze-commits.sh`, `fix-markdown-format.sh`) forward to `scripts/utils/`
+  - Feature scripts (`generate-preview-images.sh`, `install-preview-generator.sh`) forward to `scripts/features/`
+  - Maintains backward compatibility while establishing canonical locations
+
+- **Moved: `validate_preview_urls.py`** from `scripts/lib/` to `scripts/features/`
+  - Better organization as a feature-specific validator rather than core library
+
+- **Updated: Documentation** - Corrected all script path references
+  - `scripts/README.md` - New directory structure documentation
+  - `scripts/lib/README.md` - Updated test paths
+  - `docs/systems/release-automation.md` - Updated test paths
+  - `docs/TROUBLESHOOTING.md` - Updated test paths
+  - `docs/archive/PHASE_1_COMPLETE.md` - Updated historical references
+  - `docs/archive/RELEASE_WORKFLOW_IMPROVEMENTS.md` - Updated historical references
+
+### Removed
+
+- **Deleted: `scripts/lib/test/`** - Redundant test directory (tests are in `scripts/test/lib/`)
+- **Deleted: `scripts/features/preview_generator.py`** - Duplicate of `scripts/lib/preview_generator.py`
+- **Deleted: `scripts/version.sh`** - Deprecated (use `scripts/lib/version.sh` or `scripts/bin/release`)
+
+### Fixed
+
+- **Fixed: Function ordering in `scripts/bin/build`** - Moved `show_usage()` definition before it's called
+
+## [0.12.0] - 2025-11-30
+
+### Added
+
+- **New Component: `preview-image.html`** (`_includes/components/preview-image.html`)
+  - Centralized preview image rendering component
+  - Consistent handling of absolute paths and external URLs
+  - Supports custom classes, styles, and lazy loading
+  - Eliminates duplicated image rendering logic across layouts
+  
+- **New Script: `validate_preview_urls.py`** (`scripts/lib/validate_preview_urls.py`, 400+ lines)
+  - Python-based validation for preview image URLs in frontmatter
+  - Checks URL format (must start with `/`)
+  - Validates image extensions (`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`)
+  - Verifies file existence on disk
+  - Detects empty, null, or malformed preview values
+  - JSON output support for CI integration
+  - Standalone CLI tool with `--verbose`, `--suggestions`, `--list-missing` options
+  
+- **New Test Category: Content Quality Tests** in Quality Assurance Suite
+  - Added `test_preview_image_urls()` function to `test/test_quality.sh`
+  - Validates all preview URLs in content frontmatter during test runs
+  - Integrated into main test runner with new "📄 Content" category
+  - Reports missing files and format errors with suggestions
+
+### Changed
+
+- **Refactored: Layout Image Handling** - Simplified preview image logic
+  - **`_layouts/blog.html`** - Replaced 5 separate image blocks with `preview-image.html` include
+  - **`_layouts/journals.html`** - Unified preview image rendering
+  - **`_layouts/category.html`** - Consistent image component usage
+  - **`_layouts/collection.html`** - Streamlined image rendering
+  - **`_includes/components/post-card.html`** - Uses centralized component
+  - **`_includes/content/intro.html`** - Simplified image handling
+  - **`index.html`** - Updated to use preview-image component
+  - **`posts.html`** - Consistent preview image rendering
+  - **`pages/blog.md`** - Updated image handling
+
+- **Enhanced: Quality Test Suite** (`test/test_quality.sh`)
+  - Added Content Quality Tests section with preview URL validation
+  - Updated help text and summary to include content category
+  - Extended JSON report generation with content test metrics
+
+- **Fixed: Preview URL Paths** - Corrected several preview paths in content
+  - `pages/_posts/2024-06-17-wizard-topples-capitalist-dominance-ingeniously.md`
+  - `pages/_posts/2025-01-01-getting-started-jekyll.md`
+  - `pages/_posts/2025-01-05-web-accessibility-guide.md`
+  - `pages/_posts/2025-01-10-bootstrap-5-components.md`
+  - `pages/_posts/2025-01-15-docker-jekyll-guide.md`
+
+### Documentation
+
+- Updated `_includes/README.md` with `preview-image.html` component documentation
+
+---
+
+## [0.11.0] - 2025-11-30
+
+### Added
+
+- **New Feature: Jupyter Notebook Support** - Complete integration for data science and computational content
+  - **New Layout: `notebook.html`** (`_layouts/notebook.html`, 294 lines)
+    - Dedicated layout for converted notebooks with metadata display
+    - Author, date, kernel info, and reading time display
+    - Previous/next navigation between notebooks
+    - Related notebooks section
+    - Schema.org TechArticle markup for SEO
+    - Download original `.ipynb` link
+    - Giscus comments integration
+    
+  - **New Stylesheet: `notebooks.scss`** (`_sass/notebooks.scss`, 450+ lines)
+    - Code cell styling with execution counts
+    - Output area formatting (text, images, tables, errors)
+    - MathJax equation styling
+    - Responsive design with mobile breakpoints (@media max-width: 768px)
+    - Dark mode support
+    - Bootstrap 5 variable integration
+    
+  - **New Conversion Script: `convert-notebooks.sh`** (`scripts/convert-notebooks.sh`, 408 lines)
+    - Converts `.ipynb` files to Jekyll-compatible Markdown
+    - Extracts images to `/assets/images/notebooks/`
+    - Generates proper front matter with title, description, date, permalink
+    - JSON-based metadata parsing to avoid delimiter issues
+    - CLI options: `--force`, `--dry-run`, `--list`, `--clean`, `--verbose`
+    - Follows project script patterns with colored logging
+    
+  - **New GitHub Actions Workflow** (`.github/workflows/convert-notebooks.yml`, 220+ lines)
+    - Triggers on push/PR to `pages/_notebooks/**.ipynb`
+    - Dry-run mode for pull requests
+    - Automatic conversion and commit on main/develop branches
+    - Validation job checks markdown and image references
+    - Commits with `[skip ci]` to prevent loops
+    
+  - **New Documentation** (`docs/JUPYTER_NOTEBOOKS.md`)
+    - Complete feature documentation
+    - Usage examples and workflow
+    - Troubleshooting guide
+    - Architecture explanation
+    - File manifest
+    
+  - **New Test Suite** (`test-notebook-conversion.sh`, 150+ lines)
+    - 8-step automated validation
+    - Docker status, Python/nbconvert checks
+    - Conversion validation
+    - Front matter and image verification
+
+- **Makefile Targets** - Added notebook conversion commands
+  - `convert-notebooks` - Convert all notebooks
+  - `convert-notebooks-dry-run` - Preview conversions
+  - `convert-notebooks-force` - Force reconvert all
+  - `list-notebooks` - List available notebooks
+  - `clean-notebooks` - Remove converted markdown
+
+- **Sample Content** (`pages/_notebooks/test-notebook.ipynb`)
+  - Comprehensive demonstration notebook with 10 cells
+  - LaTeX equations, matplotlib plots, pandas DataFrames
+  - Fibonacci function example
+  - All outputs rendered (text, images, HTML tables)
+
+### Changed
+
+- **Enhanced: Docker Environment** (`docker/Dockerfile`)
+  - Added Python 3.13.5, pip, jupyter, nbconvert
+  - Used `--break-system-packages` flag for PEP 668 compatibility
+  - Multi-stage build preserves Python tooling
+
+- **Enhanced: Jekyll Configuration** (`_config.yml`)
+  - Added notebooks collection defaults
+  - Set `layout: notebook`, `jupyter_metadata: true`
+  - Configured sidebar navigation for notebooks
+
+- **Enhanced: Sass Import** (`_sass/custom.scss`)
+  - Added `@import "notebooks";` at top of file
+  - Ensures notebook styles load properly
+
+- **Documentation** (`README.md`)
+  - Added "Jupyter Notebook Support" feature section
+  - Installation and usage examples
+  - Feature highlights: automatic conversion, output rendering, GitHub Actions
+
 ## [0.10.6] - 2025-11-29
 
 ### Changed

data/README.md

@@ -2,7 +2,7 @@
 title: zer0-mistakes
 sub-title: Jekyll Theme
 description: Docker-optimized Jekyll theme with AI-powered installation automation and comprehensive error handling.
-version: 0.10.3
+version: 0.15.0
 layout: landing
 tags:
   - jekyll
@@ -32,8 +32,6 @@ hero_image: /assets/images/wizard-on-journey.png
 excerpt: "Professional Jekyll theme with automated installation, comprehensive error handling, and zero-configuration Docker development"
 ---
 
-<div align="center">
-
 [![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)
 [![Gem Version](https://badge.fury.io/rb/jekyll-theme-zer0.svg)](https://badge.fury.io/rb/jekyll-theme-zer0)
 [![CI](https://github.com/bamr87/zer0-mistakes/actions/workflows/ci.yml/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/ci.yml)
@@ -49,8 +47,6 @@ excerpt: "Professional Jekyll theme with automated installation, comprehensive e
 
 [Quick Start](#-quick-start) • [Features](#-key-features) • [Documentation](#-documentation) • [Contributing](CONTRIBUTING.md)
 
-</div>
-
 ---
 
 ## 📖 Table of Contents
@@ -219,12 +215,14 @@ pie title Technology Distribution
 
 | Layer | Technology | Purpose |
 |-------|-----------|---------|
-| **Framework** | Jekyll 3.9.5 | Static site generation |
+| **Framework** | Jekyll 3.10.0 | 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 |
 
 ---
 
@@ -311,6 +309,56 @@ stateDiagram-v2
 | Pie | `pie` | Distributions |
 | Git | `gitGraph` | Branch history |
 
+### 📓 Jupyter Notebook Support
+
+Seamless integration for data science and computational content:
+
+- **Automatic Conversion**: `.ipynb` → Markdown with front matter
+- **Output Rendering**: Code execution results, plots, tables preserved
+- **Image Extraction**: Matplotlib/PNG outputs → `/assets/images/notebooks/`
+- **GitHub Actions**: Automated conversion on push to `pages/_notebooks/`
+- **MathJax Support**: LaTeX equations rendered with `$$` syntax
+- **Syntax Highlighting**: Code cells with Rouge highlighting
+- **Responsive Layout**: Mobile-friendly notebook viewer
+
+```bash
+# Convert notebooks
+./scripts/convert-notebooks.sh
+
+# Add to _config.yml
+collections:
+  notebooks:
+    output: true
+    permalink: /notebooks/:name/
+```
+
+### 🧭 Enhanced Navigation System (v0.14.0)
+
+Modern, accessible sidebar navigation with advanced features:
+
+- **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
+
+| Shortcut | Action |
+|----------|--------|
+| `[` | Previous section |
+| `]` | Next section |
+| `Tab` | Skip to content |
+| Swipe | Toggle sidebar (mobile) |
+
+### 📋 Legal & Compliance Pages (v0.15.0)
+
+Built-in GDPR/CCPA compliant documentation:
+
+- **Privacy Policy**: Comprehensive data collection transparency
+- **Terms of Service**: Ready-to-customize legal framework
+- **Cookie Consent**: Granular user preference management
+
 ---
 
 ## 📦 Installation Methods
@@ -342,7 +390,7 @@ docker-compose up
 
 ```ruby
 # Gemfile
-gem "jekyll-theme-zer0", "~> 0.10"
+gem "jekyll-theme-zer0", "~> 0.15"
 ```
 
 ---
@@ -384,12 +432,13 @@ graph TD
 
 | Directory | Purpose | Key Files |
 |-----------|---------|-----------|
-| `_layouts/` | Page templates | `default.html`, `journals.html`, `landing.html` |
-| `_includes/` | Reusable components | `core/`, `components/`, `analytics/` |
-| `_sass/` | Stylesheets | `custom.scss`, `core/` |
-| `assets/` | Static files | `css/`, `js/`, `images/` |
-| `scripts/` | Automation | `release`, `build`, `version.sh` |
-| `docs/` | Technical docs | `features/`, `systems/`, `releases/` |
+| `_layouts/` | Page templates | `default.html`, `journals.html`, `landing.html`, `notebook.html` |
+| `_includes/` | Reusable components | `core/`, `components/`, `analytics/`, `navigation/` |
+| `_sass/` | Stylesheets | `custom.scss`, `notebooks.scss`, `core/` |
+| `assets/` | Static files | `css/`, `js/sidebar.js`, `images/` |
+| `scripts/` | Automation | `release`, `build`, `convert-notebooks.sh` |
+| `docs/` | Technical docs | `SIDEBAR_IMPROVEMENTS.md`, `JUPYTER_NOTEBOOKS.md` |
+| `pages/` | Content pages | `privacy-policy.md`, `terms-of-service.md` |
 
 ---
 
@@ -518,8 +567,10 @@ graph LR
 | [📋 Technical Docs](docs/) | Architecture, systems, implementation |
 | [📖 User Guides](pages/_docs/) | Published tutorials and references |
 | [🤖 Copilot Instructions](.github/copilot-instructions.md) | AI development guidelines |
-| [🌱 Seed Documentation](.github/seed/) | Full reconstruction blueprints |
+| [⌨️ Keyboard Navigation](docs/keyboard-navigation.md) | Accessibility shortcuts guide |
+| [📓 Jupyter Notebooks](docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
 | [📝 PRD](PRD.md) | Product requirements & roadmap |
+| [🔒 Privacy Policy](pages/privacy-policy.md) | GDPR/CCPA compliant privacy docs |
 
 ---
 
@@ -563,9 +614,9 @@ flowchart LR
 /opt/homebrew/bin/bash scripts/release patch --dry-run
 
 # Full release
-/opt/homebrew/bin/bash scripts/release patch  # 0.10.3 → 0.10.4
-/opt/homebrew/bin/bash scripts/release minor  # 0.10.3 → 0.11.0
-/opt/homebrew/bin/bash scripts/release major  # 0.10.3 → 1.0.0
+/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
 ```
 
 ---
@@ -577,19 +628,19 @@ gantt
     title zer0-mistakes Roadmap
     dateFormat YYYY-MM
     section Current
-    v0.10.x Maintenance       :done, 2025-11, 2025-12
+    v0.15.x Maintenance       :done, 2025-12, 2026-01
     section Future
-    v0.11 - CMS Integration   :2026-01, 2026-03
-    v0.12 - Advanced Analytics:2026-04, 2026-06
-    v0.13 - i18n Support      :2026-07, 2026-09
+    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
 ```
 
 | Version | Target | Features |
 |---------|--------|----------|
-| **v0.11** | Q1 2026 | Headless CMS integration, content API |
-| **v0.12** | Q2 2026 | A/B testing, conversion funnels |
-| **v0.13** | Q3 2026 | Multi-language support (i18n) |
+| **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) |
 | **v1.0** | Q1 2027 | Stable API, 90%+ test coverage |
 
 ---
@@ -645,11 +696,11 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 0.10.3 |
+| **Current Version** | 0.15.0 |
 | **Installation Success** | ~95% |
 | **Setup Time** | 2-5 minutes |
-| **RubyGems Downloads** | 2,500+ |
-| **Documentation** | 17,500+ lines |
+| **RubyGems Downloads** | 3,000+ |
+| **Documentation** | 20,000+ lines |
 | **Lighthouse Score** | 95+ |
 
 ---
@@ -667,11 +718,8 @@ Built with these amazing technologies:
 
 ---
 
-<div align="center">
-
 **Built with ❤️ for the Jekyll community**
 
-**v0.10.3** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
+**v0.15.0** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
 
-</div>