jekyll-theme-zer0 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 838600963804f732b859c697438cccd774d612f404097fb2c6b0c47e9e77a565
-  data.tar.gz: eb5be13266ba1956069689b5907ff6d8f78e01b4e3cce6a2f7f26ad788328a1e
+  metadata.gz: 635e2523bd58c7eb746c04e23f0e7a197c2cbaa116520aaa7bdfdc6efac8b704
+  data.tar.gz: baefeddf8d0753fc9c41aa43e0ffa2655e496a987078079f380e0358fc46dfdc
 SHA512:
-  metadata.gz: f323ebceccc8ba86d554d819a377d5ca10fe39fa4f4c6a5c93de6ecf2c3180ed39e63c20ba1880aa798c129fe9e565f22998d12f44661651d0bca7c7e0fa5dad
-  data.tar.gz: a30d36dee46ec8e56f9b4b269144f5c27f12cb7cf19bd9390e113e12035f5d00b746ce525f7c2cefd06720e3c5f11c0152675742660a1a0e2937ef8c91b45ef4
+  metadata.gz: 891551b705c5b2384197813bfd3c2d739ff45b9db06fb74f6eab824b42c1876837792c7d8ad2c3a06a557611280d0be1200ff2288b2db57133c8195007dac088
+  data.tar.gz: 869251351f5045921230e1019dcaa1cdc36c605eeab92f608085b9ebcbab511896dc1ab87ef421aa1bb1d07c89ea3a9b034331f1008a973f86410e31fe2890ea

data/CHANGELOG.md

@@ -1,9 +1,94 @@
+# Changelog
+
+## [0.6.0] - 2025-11-22
+
+### Added
+- Implement PostHog analytics and cookie consent
+- Add code copy functionality and enhance documentation structure
+- Revise copilot instructions and add comprehensive Jekyll include development guidelines
+- Implement automatic theme version display with comprehensive system information
+- Add automatic theme version display and system information integration
+- Enhance Copilot instructions with comprehensive guidelines
+- Enhance CI/CD testing framework with comprehensive documentation and automated workflows
+
+### Changed
+- Ignore .frontmatter directory
+- Update VS Code settings
+- Documentation: Update README with new features and architecture
+- Documentation: Add documentation architecture guidelines
+- Refactor: Clean up redundancies in includes.instructions.md
+- Update version control instructions and add feature documentation
+
+### Other
+- Revert "Merge pull request #10 from bamr87/copilot/plan-mdx-file-handling"
+- Add Mermaid documentation and test suite, enhance site structure
+- Merge pull request #9 from bamr87/copilot/setup-copilot-instructions
+- Merge branch 'main' into copilot/setup-copilot-instructions
+- Merge pull request #10 from bamr87/copilot/plan-mdx-file-handling
+- Address code review feedback and add summary documentation
+- Improve MDX processing and add comprehensive tests
+- Add MDX and Tailwind CSS support to zer0-mistakes theme
+- Initial plan
+- Initial plan
+
+
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Comprehensive documentation organization system in `/docs/` directory
+- Standardized templates for feature documentation, release notes, and change tracking
+- Organized directory structure for releases, features, systems, and configuration documentation
+
+### Changed
+- Migrated scattered documentation files to organized structure
+- Improved documentation discoverability and maintenance
+
+## [0.5.0] - 2025-10-25
+
+### Added
+- **📊 Comprehensive Sitemap Integration**: Unified layout combining collections, statistics, and navigation
+  - Real-time site statistics dashboard with 6 key performance indicators
+  - Interactive search and filtering across all content types
+  - Collections overview with detailed analysis and recent item previews
+  - Advanced content discovery tools with visual organization
+  - Mobile-optimized responsive design with touch-friendly interface
+  - Dark mode support with theme-aware styling
+- **🔧 Enhanced User Experience Components**: Modern interface with professional design
+  - Bootstrap 5-based responsive layout with hover animations
+  - WCAG 2.1 AA compliant accessibility features
+  - Performance-optimized loading with lazy content rendering
+  - Comprehensive documentation and implementation guides
+
+### Changed
+- **🏗️ Navigation System**: Consolidated duplicate sitemap entries into unified comprehensive view
+- **🎨 Visual Design**: Updated to modern card-based layout with smooth transitions
+- **📱 Mobile Experience**: Enhanced mobile responsiveness and touch interactions
+
+### Fixed
+- **🐛 Dark Mode Compatibility**: Resolved background color issues in dark theme
+- **🔧 Collection Filtering**: Fixed functionality for dynamic content filtering
+- **🔗 Link Navigation**: Corrected internal link behavior and navigation flow
+
+### Technical Details
+- **Files Added**: `_layouts/sitemap-collection.html`, enhanced navigation data files
+- **Files Modified**: Main navigation configuration, sitemap pages
+- **Performance**: Optimized DOM manipulation and content rendering
+- **Accessibility**: Full screen reader support and keyboard navigation
+
+**Full Documentation**: [v0.5.0 Release Summary](docs/releases/v0.5.0-release-summary.md)
+
 ## [0.4.0] - 2025-10-10
 
 ### Added
 - **📊 Comprehensive Site Statistics Dashboard**: Complete analytics system for content insights
   - Dynamic statistics generation from site content using Ruby script
-  - Real-time analytics showing 61 content pieces, 19 categories, 47 tags, 43,601 words
+  - Real-time analytics showing content pieces, categories, tags, and word counts
   - Interactive Bootstrap 5-based dashboard with responsive design
   - Modular component architecture with 6 specialized statistics components
   - Intelligent activity level calculations based on actual data distribution
@@ -38,6 +123,40 @@
   - Eliminated type conversion errors in sorting operations
   - Proper handling of nested array data structures
 
+**Full Documentation**: [v0.4.0 Release Summary](docs/releases/v0.4.0-release-summary.md)
+
+## [0.3.0] - 2025-01-27
+
+### Added
+- **🎨 Mermaid Diagram Integration v2.0**: Comprehensive diagramming system
+  - Complete diagram support: flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, git graphs, journey diagrams, and mindmaps
+  - GitHub Pages compatibility with both local development and deployment
+  - Conditional loading for performance optimization
+  - Responsive design with automatic scaling across devices
+  - Dark mode support with forest theme optimization
+- **📚 Comprehensive Documentation**: Complete user and developer guides
+  - Step-by-step user guide with live examples
+  - Developer-focused integration tutorial
+  - Live test suite with validation examples
+  - Comprehensive troubleshooting guide
+- **🧪 Automated Testing Framework**: Complete validation system
+  - 16 automated tests covering all aspects
+  - Multiple test modes: quick, local, Docker, headless
+  - Cross-browser compatibility testing
+  - Performance validation and benchmarking
+
+### Changed
+- **📁 File Organization**: 53% reduction from 15 to 7 Mermaid-related files
+- **🏗️ Architecture**: Modular include system with clear responsibilities
+- **📖 Documentation**: Consolidated and improved documentation structure
+
+### Fixed
+- **🔧 Configuration**: Enhanced Jekyll and GitHub Pages compatibility
+- **⚡ Performance**: Optimized loading and rendering speed
+- **🎯 Usability**: Improved setup process and error handling
+
+**Full Documentation**: [v0.3.0 Release Notes](docs/releases/v0.3.0-release-notes.md)
+
 ## [0.2.1] - 2025-09-30
 
 ### Added
@@ -57,32 +176,7 @@
 ## [0.2.0] - 2025-09-01
 
 ### Changed
-- Version bump to 0.2.0
-
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-- Version control best practices implementation
-- Ruby-standard version management with `lib/jekyll-theme-zer0/version.rb`
-- Enhanced gemspec with proper metadata and security settings
-- Comprehensive version control instructions file
-
-### Changed
-- Migrated from package.json to Ruby version file for version management
-- Updated GitHub Actions workflows to use Ruby version file
-- Enhanced gemspec with proper metadata and constraints
-- Improved version bump script to follow Ruby standards
-
-### Fixed
-- Version management now follows Ruby gem conventions
-- Gemspec security and metadata improvements
+- Version bump to 0.2.0 with improvements
 
 ## [0.1.9] - 2025-01-27
 
@@ -93,13 +187,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Self-healing `_config_dev.yml` generation for Docker compatibility
   - Enhanced `install.sh` with Docker-first optimization functions
   - Comprehensive Docker troubleshooting and platform detection
-
 - **🧠 AI-Powered Self-Healing Configuration**: Intelligent automation and error recovery
   - Auto-detection and resolution of Jekyll theme dependency issues
   - Intelligent platform-specific optimizations (Intel/Apple Silicon)
   - Automatic generation of Docker-compatible development configurations
   - Smart error recovery with detailed logging and guidance
-
 - **🚀 Enhanced Installation System**: Robust, error-tolerant setup process
   - `optimize_development_config()` function for Docker-friendly configs
   - `fix_content_issues()` function to resolve Jekyll include problems
@@ -117,7 +209,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Commented out problematic Jekyll includes in README.md
   - Disabled `remote_theme` in development configuration
   - Added essential Jekyll plugins for Docker compatibility
-
 - **🍎 Apple Silicon Compatibility**: Fixed Docker platform issues
   - Added `platform: linux/amd64` for Apple Silicon compatibility
   - Automatic platform detection and optimization
@@ -126,13 +217,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.8] - 2025-01-03
 
 ### Added
-- **Comprehensive Gem Automation System**: Unified automation ecosystem merging all automation features
-  - Complete documentation consolidation following IT-Journey principles (DFF, DRY, KIS, AIPD)
+- **Comprehensive Gem Automation System**: Unified automation ecosystem
   - Zero-click releases with multi-environment testing
   - Production-ready CI/CD pipeline with GitHub Actions integration
   - Semantic versioning, building, testing, and publishing automation
-
-- **Remote Installation Support**: Direct installation from GitHub using `curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash`
+  - Complete documentation consolidation following IT-Journey principles
+- **Remote Installation Support**: Direct installation from GitHub
 - **Azure Static Web Apps Integration**: Automatic workflow creation for Azure deployment
 - **Build Directory Structure**: Added `build/` directory for logs and temporary files
 - **Enhanced Error Handling**: Comprehensive error handling with colored output
@@ -140,33 +230,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - **Feature Documentation Restructure**: Consolidated redundant automation feature entries
-  - Merged `AUTOMATION_SUMMARY.md` and `automated-version-build-system.md`
-  - Created unified `comprehensive-gem-automation-system.md` feature page
-  - Updated features index to eliminate redundancies
-
-- **Simplified Installation Process**: Updated `zer0.md` to use single install command instead of complex manual setup
-- **Azure-Ready Configuration**: Pre-configured directory structure for Azure Static Web Apps (app location: `.`, api location: `api/`, output location: `_site/`)
-- **Enhanced Documentation**: Updated `INSTALLATION.md` with Azure deployment instructions
-- **Improved Help System**: Added remote installation examples to help output
+- **Simplified Installation Process**: Updated to use single install command
+- **Azure-Ready Configuration**: Pre-configured directory structure for Azure Static Web Apps
+- **Enhanced Documentation**: Updated with Azure deployment instructions
+- **Improved Help System**: Added remote installation examples
 
 ### Removed
 - **Redundant Documentation**: Eliminated duplicate automation documentation files
-  - Removed `AUTOMATION_SUMMARY.md` (content merged into comprehensive feature)
-  - Removed `automated-version-build-system.md` (superseded by comprehensive version)
-  - Consolidated 6 separate automation entries into 1 comprehensive feature
 
 ### Fixed
-- **Installation Script Compatibility**: Made `install.sh` compatible with both local and remote execution
-- **Directory Structure**: Optimized for Azure Static Web Apps deployment requirements
+- **Installation Script Compatibility**: Made compatible with both local and remote execution
+- **Directory Structure**: Optimized for Azure Static Web Apps deployment
 - **Markdown Lint Issues**: Fixed all markdown formatting violations
-  - Proper heading spacing and structure
-  - Fixed bare URLs with angle bracket notation
-  - Removed trailing spaces and improved table formatting
 
 ## [0.1.7] - 2024-12-01
 
 ### Added
-- Bootstrap Jekyll theme for headless Github Pages CMS
+- Bootstrap Jekyll theme for headless GitHub Pages CMS
 - Basic theme structure with layouts, includes, and assets
 - Jekyll compatibility with GitHub Pages
 - Scripts for version management, build, and test automation
@@ -178,7 +258,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.9...HEAD
+## Documentation
+
+For detailed documentation on features, systems, and configuration:
+- **[Documentation Center](docs/README.md)** - Complete documentation overview
+- **[Release Documentation](docs/releases/README.md)** - Historical release information
+- **[Feature Documentation](docs/features/README.md)** - Detailed feature guides
+- **[System Documentation](docs/systems/README.md)** - Core systems and automation
+- **[Configuration Guides](docs/configuration/README.md)** - Setup and configuration
+
+## Links
+
+[Unreleased]: https://github.com/bamr87/zer0-mistakes/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/bamr87/zer0-mistakes/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/bamr87/zer0-mistakes/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/bamr87/zer0-mistakes/compare/v0.2.1...v0.3.0
+[0.2.1]: https://github.com/bamr87/zer0-mistakes/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.9...v0.2.0
 [0.1.9]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/bamr87/zer0-mistakes/releases/tag/v0.1.7

data/README.md

@@ -14,7 +14,7 @@ categories:
   - docker
   - bootstrap
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2025-09-21T12:00:00.000Z
+lastmod: 2025-10-19T00:00:00.000Z
 draft: false
 permalink: /zer0/
 slug: zer0
@@ -37,9 +37,9 @@ preview: /images/zer0-mistakes-docker.png
 
 # 🚀 zer0-mistakes Jekyll Theme
 
-**Professional Jekyll theme** with AI-powered installation, Docker-first development, automated release management, and comprehensive error handling. Built for developers who value reliability, modern workflows, and zero-configuration setup.
+**Professional Jekyll theme** with AI-powered installation, Docker-first development, automated release management, and **VS Code Copilot optimization**. Built for developers who value reliability, modern workflows, AI-assisted development, and zero-configuration setup.
 
-> **🎯 95% installation success rate** • **⚡ 2-5 minute setup** • **🐳 Universal Docker compatibility** • **🤖 AI-powered error recovery** • **🚀 Automated releases with semantic versioning**
+> **🎯 95% installation success rate** • **⚡ 2-5 minute setup** • **🐳 Universal Docker compatibility** • **🤖 AI-powered error recovery** • **🚀 Automated releases with semantic versioning** • **💡 VS Code Copilot optimized**
 
 ## 🚀 Quick Start
 
@@ -110,12 +110,14 @@ docker-compose up
 
 ## ✨ What Makes This Special
 
-### 🤖 **AI-Powered Intelligence**
+### 🤖 **AI-Powered Intelligence & VS Code Copilot Integration**
 
 - **Smart Error Detection** - Automatically identifies and fixes common Jekyll issues
 - **Platform Optimization** - Detects Apple Silicon, Intel, and Linux configurations
 - **Self-Healing Setup** - Recovers from installation failures automatically
 - **Intelligent Diagnostics** - Provides actionable solutions for problems
+- **VS Code Copilot Optimized** - Structured for enhanced AI-assisted development
+- **AI Development Workflows** - Built-in patterns for maximum AI productivity
 
 ### 🐳 **Docker-First Development**
 
@@ -131,6 +133,15 @@ docker-compose up
 - **SEO Optimized** - Built-in meta tags, structured data, and social sharing
 - **Performance Focused** - Optimized loading, caching, and Core Web Vitals
 
+### 📊 **Privacy-First Analytics & Tracking**
+
+- **PostHog Integration** - Advanced analytics with privacy controls and GDPR/CCPA compliance
+- **Cookie Consent Management** - Granular user permissions with persistent preferences
+- **Custom Event Tracking** - Jekyll-specific events (downloads, navigation, reading engagement)
+- **Development Safety** - Analytics disabled in development environment
+- **User Privacy Controls** - Respect Do Not Track, opt-out mechanisms, data anonymization
+- **Comprehensive Insights** - Page views, user journeys, content engagement, and performance metrics
+
 ### 🌐 **Deployment Ready**
 
 - **GitHub Pages** - Zero-config deployment with remote theme
@@ -147,6 +158,17 @@ docker-compose up
 - **GitHub Releases** - Creates comprehensive release pages with assets
 - **CI/CD Integration** - Seamless automation with GitHub Actions
 
+### ℹ️ **Automatic Theme Version Display**
+
+- **Zero Configuration** - Theme version displays automatically, no hardcoding needed
+- **System Information** - Shows Jekyll, Ruby, and build environment details
+- **Always Accessible** - Info modal available from header (⚙️) and footer on every page
+- **Dynamic Extraction** - Version pulled from gem specification during build
+- **Comprehensive Details** - Lists active plugins, technology stack, and helpful links
+- **GitHub Pages Compatible** - Works with both local gems and remote themes
+
+[Learn more about the Theme Version Feature →](docs/THEME_VERSION_FEATURE.md)
+
 > 📖 **Learn more**: [Automated Version System Documentation](AUTOMATED_VERSION_SYSTEM.md)
 
 ### 📊 **Mermaid Diagram Integration** *(New in v0.3.0)*
@@ -161,6 +183,63 @@ 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/)
 
+## 📚 Documentation Architecture
+
+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 |
+
+**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 |
+
+**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
+- **Published online** at [zer0-mistakes.org/docs](https://bamr87.github.io/zer0-mistakes/docs/)
+
+### 🔄 **Content Flow & Conversion**
+
+```mermaid
+graph LR
+    A[Technical Docs<br/>/docs/ *.mdx] --> B[Processing Scripts]
+    B --> C[Public Docs<br/>/pages/_docs/ *.md]
+    D[External Docs<br/>Jekyll, Bootstrap] --> E[Import Scripts]
+    E --> C
+    C --> F[Jekyll Build]
+    F --> G[Published Site]
+```
+
+**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
+4. **Jekyll rendering** builds and serves final documentation site
+
+> **📍 Quick Navigation**: [Technical Docs](docs/) • [Public Documentation](pages/_docs/) • [GitHub Copilot Instructions](.github/instructions/) • [Contributing Guidelines](CONTRIBUTING.md)
+
 ## 📋 Prerequisites
 
 Before you begin, ensure you have:
@@ -602,7 +681,31 @@ git commit -m "Add amazing feature"
 git push origin feature/amazing-feature
 ```
 
-## 📄 License
+## � 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
+- **[🚀 Release Documentation](docs/releases/README.md)** - Version history and release notes
+- **[⭐ Feature Documentation](docs/features/README.md)** - Detailed feature guides and implementation
+- **[⚙️ System Documentation](docs/systems/README.md)** - Core systems, automation, and CI/CD
+- **[🔧 Configuration Guides](docs/configuration/README.md)** - Setup and hosting configuration
+- **[📝 Documentation Templates](docs/templates/README.md)** - Standardized templates for consistent documentation
+
+### 📊 Recent Releases
+- **[v0.5.0](docs/releases/v0.5.0-release-summary.md)** - Comprehensive Sitemap Integration (Latest)
+- **[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
+- **[URL Configuration](docs/configuration/url-configuration-guide.md)** - Multi-hosting setup guide
+- **[GitHub Copilot Instructions](.github/instructions/README.md)** - AI-assisted development with comprehensive coding guidelines
+
+## �📄 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.