jekyll-theme-zer0 0.8.1 → 0.10.0

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.6.0
+version: 0.9.2
 layout: landing
 tags:
   - jekyll
@@ -59,14 +59,14 @@ excerpt: "Professional Jekyll theme with automated installation, comprehensive e
 
 ### 📊 Proven Results
 
-| Metric | Traditional Jekyll | zer0-mistakes | Improvement |
-|--------|-------------------|---------------|-------------|
-| **Setup Success Rate** | ~60% | ~95% | **+58%** |
-| **Average Setup Time** | 15-30 min | 2-5 min | **-80%** |
-| **Cross-Platform Support** | Limited | Universal | **+100%** |
-| **Error Recovery** | Manual troubleshooting | Automatic fixes | **+100%** |
-| **Docker Compatibility** | Manual setup | Built-in | **+100%** |
-| **Documentation Quality** | Basic | Comprehensive | **+200%** |
+| Metric                     | Traditional Jekyll     | zer0-mistakes   | Improvement |
+| -------------------------- | ---------------------- | --------------- | ----------- |
+| **Setup Success Rate**     | ~60%                   | ~95%            | **+58%**    |
+| **Average Setup Time**     | 15-30 min              | 2-5 min         | **-80%**    |
+| **Cross-Platform Support** | Limited                | Universal       | **+100%**   |
+| **Error Recovery**         | Manual troubleshooting | Automatic fixes | **+100%**   |
+| **Docker Compatibility**   | Manual setup           | Built-in        | **+100%**   |
+| **Documentation Quality**  | Basic                  | Comprehensive   | **+200%**   |
 
 ---
 
@@ -75,11 +75,13 @@ excerpt: "Professional Jekyll theme with automated installation, comprehensive e
 ### 📋 System Requirements
 
 **Required:**
+
 - **Docker Desktop** - Universal cross-platform development environment
 - **Git** - Version control
 - **Bash 4.0+** - For release automation (macOS: `brew install bash`)
 
 **Optional:**
+
 - **GitHub CLI** - Enhanced GitHub integration
 - **Ruby 3.0+** - For local (non-Docker) development
 
@@ -98,6 +100,7 @@ docker-compose up
 ```
 
 **What this does automatically:**
+
 - ✅ Detects your platform (Apple Silicon, Intel, Linux)
 - ✅ Downloads and configures all theme files
 - ✅ Sets up Docker development environment
@@ -110,6 +113,7 @@ docker-compose up
 <summary>Click to expand manual installation methods</summary>
 
 #### Method 1: GitHub Remote Theme
+
 Perfect for GitHub Pages hosting:
 
 ```bash
@@ -121,6 +125,7 @@ gem "jekyll-remote-theme"
 ```
 
 #### Method 2: Fork & Customize
+
 For extensive theme development:
 
 ```bash
@@ -133,6 +138,7 @@ docker-compose up
 ```
 
 #### Method 3: Local Installation
+
 Install from local repository:
 
 ```bash
@@ -213,7 +219,7 @@ docker-compose up
 
 > 📖 **Learn more**: [Automated Version System Documentation](AUTOMATED_VERSION_SYSTEM.md)
 
-### 📊 **Mermaid Diagram Integration** *(New in v0.3.0)*
+### 📊 **Mermaid Diagram Integration** _(New in v0.3.0)_
 
 - **Complete Diagram Support** - Flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, git graphs, journey diagrams, and mindmaps
 - **GitHub Pages Compatible** - Works seamlessly with both local development and GitHub Pages deployment
@@ -225,7 +231,7 @@ docker-compose up
 
 > 📖 **Learn more**: [Mermaid Documentation](/docs/jekyll/mermaid/) • [Integration Tutorial](/docs/jekyll/jekyll-diagram-with-mermaid/) • [Test Suite](/docs/jekyll/mermaid-test-suite/)
 
-### 🌱 **Comprehensive Seed Documentation System** *(New in v0.6.0)*
+### 🌱 **Comprehensive Seed Documentation System** _(New in v0.6.0)_
 
 - **Complete Rebuild Blueprint** - 17,500+ lines of documentation for full project reconstruction
 - **AI Agent Optimized** - Structured for autonomous project building with 95%+ success rate
@@ -241,33 +247,37 @@ docker-compose up
 Zer0-Mistakes features a **dual documentation structure** designed for different audiences and use cases:
 
 ### 🛠️ **Technical Documentation** → [`/docs/`](docs/)
+
 **Repository-specific technical documentation** (MDX format) for developers and contributors:
 
-| Directory | Purpose | Target Audience |
-|-----------|---------|----------------|
-| [`/docs/systems/`](docs/systems/) | Infrastructure automation, CI/CD, build processes | DevOps & Contributors |
-| [`/docs/features/`](docs/features/) | Theme feature implementation, component architecture | Developers & Maintainers |
-| [`/docs/configuration/`](docs/configuration/) | Development setup, Docker, environment configuration | Contributors |
-| [`/docs/releases/`](docs/releases/) | Version history, migration guides, technical changes | All Technical Users |
-| [`/docs/jekyll/`](docs/jekyll/) | Jekyll optimization, plugins, advanced configuration | Jekyll Developers |
+| Directory                                     | Purpose                                              | Target Audience          |
+| --------------------------------------------- | ---------------------------------------------------- | ------------------------ |
+| [`/docs/systems/`](docs/systems/)             | Infrastructure automation, CI/CD, build processes    | DevOps & Contributors    |
+| [`/docs/features/`](docs/features/)           | Theme feature implementation, component architecture | Developers & Maintainers |
+| [`/docs/configuration/`](docs/configuration/) | Development setup, Docker, environment configuration | Contributors             |
+| [`/docs/releases/`](docs/releases/)           | Version history, migration guides, technical changes | All Technical Users      |
+| [`/docs/jekyll/`](docs/jekyll/)               | Jekyll optimization, plugins, advanced configuration | Jekyll Developers        |
 
 **Key characteristics:**
+
 - **MDX format** with interactive components and rich code examples
 - **Source code focused** with direct references to `_layouts/`, `_includes/`, `scripts/`
 - **Architecture documentation** explaining how features are built and maintained
 - **Developer workflows** including testing, deployment, and contribution guidelines
 
 ### 📖 **Public Documentation** → [`/pages/_docs/`](pages/_docs/)
+
 **Published online documentation** (Markdown format) for end-users and general developers:
 
-| Content Type | Purpose | Source |
-|--------------|---------|--------|
-| **Technology Guides** | General Jekyll, Bootstrap, Ruby documentation | Imported & curated external docs |
-| **User Tutorials** | How to use and customize the theme | Original content for users |
-| **Reference Materials** | API docs, configuration options, troubleshooting | Converted from technical docs |
-| **External Imports** | Official documentation from Jekyll, Bootstrap, etc. | Git submodules & processing scripts |
+| Content Type            | Purpose                                             | Source                              |
+| ----------------------- | --------------------------------------------------- | ----------------------------------- |
+| **Technology Guides**   | General Jekyll, Bootstrap, Ruby documentation       | Imported & curated external docs    |
+| **User Tutorials**      | How to use and customize the theme                  | Original content for users          |
+| **Reference Materials** | API docs, configuration options, troubleshooting    | Converted from technical docs       |
+| **External Imports**    | Official documentation from Jekyll, Bootstrap, etc. | Git submodules & processing scripts |
 
 **Key characteristics:**
+
 - **Markdown format** optimized for Jekyll rendering and online consumption
 - **User-focused** content targeting theme adopters and general developers
 - **Processed content** converted from MDX sources and external documentation
@@ -286,6 +296,7 @@ graph LR
 ```
 
 **Documentation Workflow:**
+
 1. **Technical implementation** documented in `/docs/` using MDX for rich content
 2. **Processing pipeline** converts and sanitizes content for public consumption
 3. **External documentation** imported from official sources and integrated
@@ -302,6 +313,7 @@ Before you begin, ensure you have:
 - **Text Editor** - VS Code, Sublime Text, or your preferred editor
 
 **Optional but helpful:**
+
 - **GitHub CLI** - For easier repository management
 - **Ruby 3.0+** - If you prefer local development over Docker
 
@@ -557,12 +569,14 @@ docker-compose down                   # Stop services
 Our testing framework validates the entire installation and deployment process:
 
 #### Quick Validation (30 seconds)
+
 ```bash
 # Fast validation without Docker
 ./test/validate_installation.sh
 ```
 
 #### Docker Deployment Test (2-3 minutes)
+
 ```bash
 # Test Docker-specific functionality
 ./test/test_docker_deployment.sh --verbose
@@ -572,6 +586,7 @@ Our testing framework validates the entire installation and deployment process:
 ```
 
 #### Complete Installation Test (3-5 minutes)
+
 ```bash
 # Test all installation methods
 ./test/test_installation_complete.sh
@@ -581,6 +596,7 @@ Our testing framework validates the entire installation and deployment process:
 ```
 
 #### End-to-End Deployment Test (5-10 minutes)
+
 ```bash
 # Full deployment workflow validation
 ./test/test_deployment_complete.sh
@@ -592,6 +608,7 @@ Our testing framework validates the entire installation and deployment process:
 ### 🎯 Test Results Interpretation
 
 **✅ Success Indicators:**
+
 - HTTP 200 OK response from `http://localhost:4000`
 - Jekyll logs show "Server running... press ctrl-c to stop"
 - Site content includes zer0-mistakes theme elements
@@ -599,12 +616,14 @@ Our testing framework validates the entire installation and deployment process:
 - Build time under 5 seconds
 
 **⚠️ Common Issues:**
+
 - **Port conflicts:** Use `docker-compose run -p 4001:4000 jekyll`
 - **Volume mounting:** Use home directory instead of `/tmp`
 - **Bundle install slow:** Normal for first run (60-90 seconds)
 - **Repository errors:** Check `PAGES_REPO_NWO` environment variable
 
 **❌ Failure Indicators:**
+
 - Gemfile contains `gemspec` (should be site-configured)
 - Docker container exits immediately
 - `_config.yml` syntax errors
@@ -613,6 +632,7 @@ Our testing framework validates the entire installation and deployment process:
 ### 🎉 Validated Test Results
 
 **Latest Test Results (September 21, 2025):**
+
 ```
 ✅ Docker Deployment Test: 5/5 tests PASSED (100% success rate)
 ✅ Installation Process: All files and directories created correctly
@@ -624,6 +644,7 @@ Our testing framework validates the entire installation and deployment process:
 ```
 
 **Test Environment:**
+
 - **OS:** macOS (Apple Silicon)
 - **Docker:** Available and functional
 - **Ruby:** 2.6.10 (system)
@@ -638,6 +659,7 @@ The theme installation and deployment process has been **thoroughly tested and v
 ### Quick Fixes
 
 **🐳 Docker Issues:**
+
 ```bash
 # Restart Docker Desktop
 # Then rebuild containers
@@ -645,12 +667,14 @@ docker-compose down && docker-compose up --build
 ```
 
 **⚡ Port Conflicts:**
+
 ```bash
 # Use different port
 docker-compose run -p 4001:4000 jekyll
 ```
 
 **🍎 Apple Silicon Issues:**
+
 ```bash
 # Force platform if needed
 docker-compose up --build
@@ -756,6 +780,7 @@ scripts/release patch --skip-publish --no-github-release
 ```
 
 **System Requirements:**
+
 - Bash 4.0+ (install on macOS: `brew install bash`)
 - Clean git working directory
 - RubyGems credentials configured
@@ -765,6 +790,7 @@ For details, see [Release Workflow](CONTRIBUTING.md#-release-process) and [Phase
 ## � Documentation
 
 ### 📖 Comprehensive Documentation Center
+
 All documentation is organized in the [`docs/`](docs/README.md) directory:
 
 - **[📋 Documentation Overview](docs/README.md)** - Complete documentation center with organized structure
@@ -775,6 +801,7 @@ All documentation is organized in the [`docs/`](docs/README.md) directory:
 - **[📝 Documentation Templates](docs/templates/README.md)** - Standardized templates for consistent documentation
 
 ### 🌱 Seed Documentation (AI & Developer Blueprints)
+
 Comprehensive reconstruction documentation for AI agents and developers:
 
 - **[Seed Documentation System](.github/seed/README.md)** - Master index and navigation guide (17,500+ lines total)
@@ -785,12 +812,14 @@ Comprehensive reconstruction documentation for AI agents and developers:
 - **[Component Library](.github/seed/seed.components.md)** - Complete theme components (~4,000 lines)
 
 ### 📊 Recent Releases
+
 - **[v0.6.0](CHANGELOG.md#060---2025-11-22)** - AI Integration & Privacy Compliance (Current)
 - **[v0.5.0](docs/releases/v0.5.0-release-summary.md)** - Comprehensive Sitemap Integration
 - **[v0.4.0](docs/releases/v0.4.0-release-summary.md)** - Statistics Dashboard
 - **[v0.3.0](docs/releases/v0.3.0-release-notes.md)** - Mermaid Integration v2.0
 
 ### 🌟 Key Features
+
 - **[Sitemap Integration](docs/features/sitemap-integration.md)** - Unified site navigation and content discovery
 - **[Automated Version System](docs/systems/automated-version-system.md)** - Intelligent release automation
 - **[CI/CD Pipeline](docs/systems/cicd-status-report.md)** - Comprehensive testing and deployment
@@ -810,26 +839,30 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 **RubyGems Downloads**: 2,500+  
 **Test Coverage**: 60% (Target: 90% by v0.8.0)  
 **Documentation**: 17,500+ lines of seed docs + comprehensive guides  
-**Lighthouse Score**: 95+  
+**Lighthouse Score**: 95+
 
 ## 🗺️ Roadmap
 
 **v0.7.0** (Q2 2026) - Headless CMS Integration
+
 - Content API (REST/GraphQL)
 - Visual front matter editor
 - Multi-author collaboration
 
 **v0.8.0** (Q3 2026) - Advanced Analytics & UX
+
 - A/B testing framework
 - Conversion funnels
 - Visual theme customizer
 
 **v0.9.0** (Q4 2026) - Enhanced Developer Experience
+
 - Multi-language support (i18n)
 - Component library browser
 - Interactive setup wizard
 
 **v1.0.0** (Q1 2027) - Production Milestone
+
 - 90%+ test coverage
 - Enterprise support
 - Stable API guarantee

data/_data/README.md

@@ -1,4 +1,3 @@
-
 ## Getting Started
 
 These instructions will help you understand the data files in this directory.
@@ -17,7 +16,7 @@ Please read [CONTRIBUTING.md](url) for details on our code of conduct, and the p
 
 ## Authors
 
-* **Your Name** - *Initial work* - [YourGithub](url)
+- **Your Name** - _Initial work_ - [YourGithub](url)
 
 See also the list of [contributors](url) who participated in this project.
 
@@ -27,6 +26,6 @@ This project is licensed under the MIT License - see the [LICENSE.md](url) file
 
 ## Acknowledgments
 
-* Hat tip to anyone whose code was used
-* Inspiration
-* etc
+- Hat tip to anyone whose code was used
+- Inspiration
+- etc

data/_includes/README.md

@@ -1,4 +1,4 @@
-# _includes Directory Organization
+# \_includes Directory Organization
 
 This directory has been reorganized for better maintainability and clarity. Files are now grouped by functionality into subdirectories.
 

data/_includes/stats/README.md

@@ -35,7 +35,6 @@ description: "Comprehensive analytics and metrics"
 layout: stats
 permalink: /stats/
 ---
-
 Your additional content here (optional).
 ```
 
@@ -57,30 +56,35 @@ tags:
 ### Components Overview
 
 #### stats-header.html
+
 - Displays page title and description
 - Shows last update timestamp
 - Provides navigation breadcrumbs
 - Includes quick jump links to sections
 
 #### stats-overview.html
+
 - Four key metric cards (Posts, Categories, Tags, Data Status)
 - Color-coded cards with Bootstrap styling
 - Data freshness indicators
 - Summary bar below cards
 
 #### stats-categories.html
+
 - Top categories list with post counts
 - Activity level indicators
 - Summary statistics footer
 - Expandable interface for large datasets
 
 #### stats-tags.html
+
 - Top tags list with usage counts
 - Interactive tag cloud visualization
 - Dynamic font sizing based on usage
 - Hover effects and tooltips
 
 #### stats-metrics.html
+
 - Content overview section
 - Top performers analysis
 - Data health indicators
@@ -88,6 +92,7 @@ tags:
 - Help modal with instructions
 
 #### stats-no-data.html
+
 - Error state when data is missing
 - Clear instructions for generating statistics
 - Troubleshooting information
@@ -141,24 +146,28 @@ The layout expects data from `site.data.content_statistics`. You can:
 ## Features
 
 ### Responsive Design
+
 - Mobile-first approach
 - Responsive grid layouts
 - Touch-friendly interactions
 - Optimized for all screen sizes
 
 ### Accessibility
+
 - ARIA labels and roles
 - Keyboard navigation support
 - Screen reader compatibility
 - High contrast mode support
 
 ### Performance
+
 - Lazy loading of non-critical elements
 - Optimized CSS delivery
 - Minimal JavaScript footprint
 - Print-optimized styles
 
 ### Interactive Elements
+
 - Hover effects on cards and tags
 - Smooth animations and transitions
 - Modal dialogs for additional information
@@ -167,6 +176,7 @@ The layout expects data from `site.data.content_statistics`. You can:
 ## Browser Support
 
 The statistics layout supports all modern browsers:
+
 - Chrome 90+
 - Firefox 88+
 - Safari 14+
@@ -240,12 +250,14 @@ permalink: /metrics/
 Our analytics system tracks various metrics to help understand content performance and user engagement.
 
 ### Key Metrics
+
 - Content reach and engagement
 - Category performance trends
 - Tag effectiveness analysis
 - User interaction patterns
 
 ### Data Collection
+
 Statistics are updated daily and include all published content from the past 12 months.
 ```
 
@@ -270,4 +282,4 @@ To contribute improvements to the statistics layout:
 4. Test across multiple browsers
 5. Ensure accessibility compliance
 
-For more information, see the main theme documentation.
+For more information, see the main theme documentation.

data/_layouts/README.md

@@ -150,7 +150,7 @@ Each layout file now includes:
 ```html
 <!-- Explain complex logic or conditional statements -->
 {% if condition %}
-    <!-- Why this condition exists and what it affects -->
+<!-- Why this condition exists and what it affects -->
 {% endif %}
 ```
 
@@ -202,5 +202,5 @@ Each layout file now includes:
 
 ---
 
-*These layouts follow the Zer0-Mistakes theme standards for maintainable,  
-documented, and responsive Jekyll templates.*
+_These layouts follow the Zer0-Mistakes theme standards for maintainable,  
+documented, and responsive Jekyll templates._

data/_sass/core/_theme.scss

@@ -1,8 +1,11 @@
+// Import variables for standalone compilation
+@import "variables";
+
 // # Font Settings ---------------------------------------------------------------
 
 // # Color Settings --------------------------------------------------------------
 
-// ## Color Schema Override 
+// ## Color Schema Override
 //  https://meodai.github.io/poline/
 
 // Harbour Mirror

data/scripts/bin/build

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Simplified build command for zer0-mistakes Jekyll theme
+# Usage: ./scripts/build [options]
+#
+# Quick gem building without the full release workflow.
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+# Source required libraries
+source "$LIB_DIR/common.sh"
+source "$LIB_DIR/validation.sh"
+source "$LIB_DIR/version.sh"
+source "$LIB_DIR/gem.sh"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            export DRY_RUN=true
+            shift
+            ;;
+        --verbose)
+            export VERBOSE=true
+            shift
+            ;;
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        *)
+            error "Unknown option: $1 (use --help for usage)"
+            ;;
+    esac
+done
+
+# Show usage
+show_usage() {
+    cat << EOF
+🔨 Simplified Build Command for zer0-mistakes
+
+USAGE:
+    ./scripts/bin/build [OPTIONS]
+
+DESCRIPTION:
+    Builds the Jekyll theme gem without running the full release workflow.
+    Useful for testing gem packaging or preparing for manual publication.
+
+OPTIONS:
+    --dry-run     Preview build without creating files
+    --verbose     Show detailed debug output
+    --help, -h    Show this help message
+
+EXAMPLES:
+    ./scripts/bin/build                # Build gem with current version
+    ./scripts/bin/build --dry-run      # Preview what would be built
+    ./scripts/build --verbose      # Build with debug output
+
+ENVIRONMENT VARIABLES:
+    DRY_RUN=true     Enable dry run mode
+    VERBOSE=true     Enable debug output
+
+OUTPUT:
+    Creates: jekyll-theme-zer0-VERSION.gem in current directory
+
+For full release workflow, use: ./scripts/release
+EOF
+}
+
+# Main build workflow
+main() {
+    print_header "🔨 Gem Build"
+    
+    # Step 1: Basic validation (no RubyGems auth needed for build)
+    step "Validating environment..."
+    validate_git_repo
+    validate_required_files
+    validate_gemspec
+    success "Environment validated"
+    echo ""
+    
+    # Step 2: Get current version
+    step "Reading version..."
+    local version
+    version=$(get_current_version)
+    info "Current version: $version"
+    info "Gem file: jekyll-theme-zer0-${version}.gem"
+    echo ""
+    
+    # Step 3: Build gem
+    build_gem "$version"
+    echo ""
+    
+    # Success summary
+    if [[ "$DRY_RUN" != "true" ]]; then
+        print_summary "Build Complete" \
+            "✅ Built: jekyll-theme-zer0-${version}.gem" \
+            "" \
+            "Next steps:" \
+            "  • Test: gem install jekyll-theme-zer0-${version}.gem" \
+            "  • Publish: gem push jekyll-theme-zer0-${version}.gem" \
+            "  • Or use: ./scripts/release for full workflow"
+    else
+        info "Dry run complete - no files created"
+    fi
+    
+    success "Build completed successfully!"
+}
+
+# Run main function
+main "$@"