jekyll-theme-zer0 0.7.2 → 0.10.0

data/README.md

@@ -2,8 +2,8 @@
 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
-layout: default
+version: 0.9.2
+layout: landing
 tags:
   - jekyll
   - docker
@@ -14,9 +14,9 @@ categories:
   - docker
   - bootstrap
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2025-10-19T00:00:00.000Z
+lastmod: 2025-11-27T00:00:00.000Z
 draft: false
-permalink: /zer0/
+permalink: /
 slug: zer0
 keywords:
   - jekyll
@@ -26,7 +26,9 @@ keywords:
 date: 2025-09-21T12:00:00.000Z
 snippet: Docker-first Jekyll theme with remote theme support
 comments: true
-preview: /images/zer0-mistakes-docker.png
+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"
 ---
 
 [![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,16 +43,45 @@ preview: /images/zer0-mistakes-docker.png
 
 > **🎯 95% installation success rate** • **⚡ 2-5 minute setup** • **🐳 Universal Docker compatibility** • **🤖 AI-powered error recovery** • **🚀 Automated releases with semantic versioning** • **💡 VS Code Copilot optimized**
 
+---
+
+## Welcome to Error-Free Jekyll Development
+
+**zer0-mistakes** eliminates the complexity and frustration of Jekyll theme setup with intelligent automation, Docker-first development, and comprehensive error handling. Get a professional Jekyll site running in minutes, not hours.
+
+### 🎯 Perfect For
+
+- **Developers** who value reliable, reproducible development environments
+- **Teams** needing consistent setup across different machines and platforms
+- **Content creators** who want to focus on writing, not configuration
+- **DevOps engineers** seeking containerized, scalable Jekyll deployments
+- **Anyone** who's struggled with Jekyll theme installation and dependency issues
+
+### 📊 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%**   |
+
+---
+
 ## 🚀 Quick Start
 
 ### 📋 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
 
@@ -69,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
@@ -81,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
@@ -92,6 +125,7 @@ gem "jekyll-remote-theme"
 ```
 
 #### Method 2: Fork & Customize
+
 For extensive theme development:
 
 ```bash
@@ -104,6 +138,7 @@ docker-compose up
 ```
 
 #### Method 3: Local Installation
+
 Install from local repository:
 
 ```bash
@@ -184,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
@@ -196,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
@@ -212,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
@@ -257,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
@@ -273,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
 
@@ -528,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
@@ -543,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
@@ -552,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
@@ -563,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
@@ -570,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
@@ -584,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
@@ -595,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)
@@ -609,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
@@ -616,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
@@ -727,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
@@ -736,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
@@ -746,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)
@@ -756,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
@@ -781,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._