jekyll-theme-zer0 0.8.1 → 0.10.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 733d8704f50748a918ed57f3e7a59dce4206763265456dde795643f7e9cc2b63
-  data.tar.gz: 0f7e1075d4975fee6d1fbe283d93e9d5fc791d2226877c6e949828110cc9779b
+  metadata.gz: d85d69f52f828fb686300bac5c2312c0c8bfbd1eed9059fab3c071073efb003b
+  data.tar.gz: dd68d098ec262a62b7ab3c50163830467fdaa36fe3cbba9c00941e6893f334bd
 SHA512:
-  metadata.gz: 244c31f280895d914cd5a4b6d1a7199e8d134e5daf9d5b1c33a3454b35b7aa65245396a2e1884e3900732ccbb1d07552863cd7b35c1a0aaffe0ab886473f73cf
-  data.tar.gz: 8a6362bc14e3f7c02d9928d068d98039d69965cfeae0f3a0591845059fe00391a0adb67df3870352f0d4f928c855365933794148241332c8272738e46aceda89
+  metadata.gz: c352ba15e82dfdeb1945caddbc35fff0dc7c8d26431d1d73f5ba66fb51055fa0ba046bdcde3f4c4e48d5ddcafc8bcdca50ce43b39a656e85ba95af656a274b21
+  data.tar.gz: a52ea996e45089efcb33286a86555e6f340d93273e45552455e2b5331564fe0ce3cbc781246372d1fac567f5a974cb4cf6b5613caa9a798eec7d1a69587459a4

data/CHANGELOG.md

@@ -1,5 +1,282 @@
 # Changelog
 
+## [0.10.3] - 2025-11-29
+
+### Added
+
+- **New: AI-Generated Preview Images** - 17 new preview images for posts and collections
+  - Business, Development, Science, Technology, Tutorial, World category index pages
+  - Individual post previews: startup funding, quantum computing, AI tools, CSS grid, remote work
+  - Quickstart guide previews: GitHub setup, Jekyll setup, machine setup
+  - Documentation and blog index previews
+
+### Changed
+
+- **Improved: Preview Image Path Handling** (`_layouts/journals.html`, `_layouts/category.html`, `_layouts/collection.html`)
+  - Layouts now support both absolute paths (`/assets/...`) and relative paths
+  - Conditional logic detects path type and constructs URL correctly
+  - Eliminates double-slash issues in image URLs
+
+- **Improved: Intro Section Preview Image Logic** (`_includes/content/intro.html`)
+  - Smart path detection for preview images (absolute vs relative)
+  - Handles URLs with `://` schemes, paths starting with `/`, and relative filenames
+  - Cleaner Liquid template logic with proper variable assignment
+
+- **Improved: Docker Development Setup** (`docker-compose.yml`, `docker/Dockerfile`)
+  - Command now runs `bundle install` before Jekyll serve (fixes volume mount overwrites)
+  - Dockerfile copies gemspec and lib/ for proper dependency resolution
+  - More reliable container startup with dependency installation
+
+- **Improved: Preview Image Generator** (`scripts/lib/preview_generator.py`)
+  - Switched from OpenAI SDK to direct HTTP API calls
+  - Eliminates SDK dependency - only requires `requests` package
+  - Better error handling with HTTP status code parsing
+  - Added request timeouts (120s for generation, 60s for download)
+
+### Fixed
+
+- **Fixed: Asset Paths in Config** (`_config.yml`)
+  - Corrected `teaser` and `info_banner` paths to use `/assets/images/` prefix
+  - Images now load correctly across all pages
+
+- **Fixed: Preview Image Double-Slash URLs**
+  - Removed extra `/` between `public_folder` and `site.teaser` in fallback images
+  - All layouts now generate clean, valid image URLs
+
+## [0.10.2] - 2025-11-28
+
+### Added
+
+- **Enhanced: Navbar Auto-Hide on Scroll** (`assets/js/auto-hide-nav.js`)
+  - Navbar hides when scrolling down past 100px threshold
+  - Navbar reappears immediately when scrolling up
+  - Automatic body padding to prevent content jump under fixed navbar
+  - Performance-optimized with `requestAnimationFrame` throttling
+  - Respects `prefers-reduced-motion` accessibility setting
+
+### Changed
+
+- **Improved: Header Positioning** (`_includes/core/header.html`)
+  - Changed from `z-1` to Bootstrap's `fixed-top` class
+  - Provides proper z-index (1030) and fixed positioning
+
+- **Refactored: Navbar CSS** (`_sass/custom.scss`)
+  - Replaced broken `.hide-navbar` and `.fixed-navbar` classes
+  - New `.navbar-hidden` class with `translateY(-100%)` transform
+  - Added `!important` to override Bootstrap's `fixed-top` positioning
+  - Added explicit background color for opaque navbar
+  - Added `prefers-reduced-motion` media query for accessibility
+
+### Fixed
+
+- **Fixed: Navbar Blocking Content on Scroll Up**
+  - Content no longer obscured when scrolling back to top
+  - Body padding dynamically calculated based on navbar height
+
+## [0.10.1] - 2025-11-28
+
+### Added
+
+- **Enhanced: Mermaid v2.1 - GitHub Pages Compatible** (`_includes/components/mermaid.html`)
+  - Client-side conversion of native markdown ` ```mermaid ` code blocks to rendered diagrams
+  - Full GitHub Pages compatibility without custom plugins (all processing client-side)
+  - CSS to hide code blocks during conversion (prevents flash of unstyled content)
+  - Print styles and improved responsive design
+  - Documented dual syntax support (native markdown and HTML div)
+
+### Changed
+
+- **Improved: Mermaid Configuration** (`_config.yml`)
+  - Added clear comments explaining GitHub Pages compatibility
+  - Documented that `jekyll-mermaid` plugin is optional
+  - Updated usage instructions for both syntax options
+
+- **Improved: Mermaid Documentation**
+  - `docs/jekyll/mermaid.md`: Added native markdown syntax as recommended option
+  - `docs/jekyll/mermaid-native-markdown.md`: Fixed documentation about front matter requirements
+  - Added GitHub Pages compatibility badges to documentation
+
+### Fixed
+
+- **Fixed: Native Markdown Mermaid Syntax Not Rendering**
+  - ` ```mermaid ` code blocks now properly convert to diagrams via JavaScript
+  - Works with GitHub Pages remote_theme deployment
+
+- **Fixed: Mermaid Test Script** (`scripts/test-mermaid.sh`)
+  - Corrected file path references from `pages/_docs/jekyll/` to `docs/jekyll/`
+  - Fixed SIGPIPE issues with `curl | grep` pipelines causing false test failures
+  - All 21 tests now pass successfully
+
+## [0.10.0] - 2025-11-28
+
+### Added
+
+- **New: Zero Version Pin Strategy** - Enterprise-grade dependency management paradigm
+  - Always use latest compatible versions with zero pins anywhere
+  - Fail fast in CI if incompatible → caught early, not in production
+  - Production uses immutable image tags (date+commit hash), never `:latest`
+  - Full documentation in `docs/systems/ZERO_PIN_STRATEGY.md`
+
+- **New: Docker Multi-Stage Dockerfile** (`docker/Dockerfile`)
+  - `base` stage: Ruby slim + build dependencies
+  - `dev-test` stage: Full dev/test gems for CI validation
+  - `build` stage: Production Jekyll build
+  - `production` stage: Minimal runtime for serving
+
+- **New: Docker Compose Configurations**
+  - `docker-compose.yml`: Development environment with live reload
+  - `docker-compose.test.yml`: CI testing overlay with validation
+  - `docker-compose.prod.yml`: Production with immutable tags only
+
+- **New: CI Workflow for Zero Pin Strategy** (`.github/workflows/test-latest.yml`)
+  - Builds with `--no-cache` for latest dependencies
+  - Documents resolved versions in workflow summary
+  - Tags and publishes immutable images on success
+  - Debug information on failure
+
+- **New: `.dockerignore`** - Optimized Docker build context
+  - Excludes development files, tests, logs, and build artifacts
+  - Keeps only files needed for container builds
+
+- **New: VS Code Workspace Configuration** (`zer0-mistakes.code-workspace`)
+  - Copilot settings for all file types
+  - File associations for Jekyll/Liquid
+  - Terminal environment variables for Docker
+
+### Changed
+
+- **Improved: `Gemfile`** - Refactored for zero version pin strategy
+  - Removed all version constraints
+  - Added development/test group with html-proofer, rspec, rake, rubocop
+  - Added platform-specific dependencies for Windows
+  - Comprehensive documentation comments
+
+- **Improved: `docker-compose.yml`** - Enhanced for zero pin strategy
+  - Uses custom Dockerfile instead of jekyll/jekyll image
+  - Added bundle cache volume for faster rebuilds
+  - LiveReload port (35729) exposed
+  - TTY enabled for interactive commands
+
+- **Improved: `jekyll-theme-zer0.gemspec`** - Compatibility updates
+  - Ruby requirement lowered to >= 2.7.0 (from 3.0.0) for broader compatibility
+  - Bundler dependency changed to ~> 2.3 (from >= 2.3)
+
+- **Improved: CI Workflow** (`.github/workflows/ci.yml`)
+  - Added documentation comments explaining version strategy
+  - Clarified that explicit versions are for backwards compatibility testing
+
+### Fixed
+
+- **Fixed: `scripts/generate-preview-images.sh`** - Reverted to simpler collection handling
+  - Removed dynamic collection reading (caused issues in some environments)
+  - Restored hardcoded collection list for reliability
+  - Fixed yq vs sed front matter update logic
+
+## [0.9.2] - 2025-11-28
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 509d705 fix(ci): fix false positive failure detection in test report validation
+- 77dc04b fix(ci): fix shell syntax error in test-suite validation step
+
+
+## [0.9.1] - 2025-11-27
+
+### Fixed
+
+- **CI: Test suite failures across Ruby versions** - Resolved issues causing CI failures
+  - Fixed `--skip-docker` option error by only passing it to deployment tests (not quality tests)
+  - Fixed bash arithmetic syntax error in Liquid tag validation by sanitizing grep output
+  - Added bundler 2.5 requirement to setup-ruby action for Ruby 3.0 compatibility
+
+## [0.9.0] - 2025-06-30
+
+### Changed
+
+- **Refactored: Scripts Directory Structure** - Complete reorganization for better maintainability
+  - New `bin/` directory for main entry points (`release`, `build`, `test`)
+  - New `utils/` directory for utility scripts (`setup`, `analyze-commits`, `fix-markdown`)
+  - New `features/` directory for feature-specific scripts (`generate-preview-images`, `install-preview-generator`)
+  - New `test/` directory hierarchy with `lib/`, `theme/`, and `integration/` subdirectories
+  - Unified test runner in `bin/test` that runs all test suites with single command
+
+- **Improved: Script Library Integration** - All scripts now use shared `lib/common.sh`
+  - Consistent logging functions (`log`, `info`, `success`, `warn`, `error`, `debug`)
+  - Standardized color output and formatting
+  - Removed duplicate code from individual scripts
+
+- **Updated: Documentation** - Complete rewrite of `scripts/README.md`
+  - Clear directory structure overview
+  - Quick start guide for common operations
+  - Migration table from legacy to new script locations
+  - Dependency graph for library modules
+
+### Added
+
+- **New: `bin/test` Unified Test Runner** - Single command to run all tests
+  - Supports running specific test suites (`lib`, `theme`, `integration`, `all`)
+  - Verbose output mode with `--verbose` flag
+  - Summary of passed/failed test suites
+
+- **New: `test/theme/validate`** - Theme structure validation tests
+  - Validates layouts, includes, and assets directories
+  - Sources shared library for consistent output
+
+- **New: `test/integration/auto-version`** - Auto-version integration tests
+  - Moved from `tests/` directory with updated library paths
+
+### Deprecated
+
+- **Deprecated: `scripts/version.sh`** - Now displays deprecation warning
+  - Recommends using `bin/release` for full workflow
+  - Will be removed in future release
+
+### Migration Guide
+
+| Legacy Script | New Location |
+|--------------|--------------|
+| `version.sh` | `bin/release` |
+| `setup.sh` | `utils/setup` |
+| `test.sh` | `bin/test` or `test/theme/validate` |
+| `analyze-commits.sh` | `utils/analyze-commits` |
+| `fix-markdown-format.sh` | `utils/fix-markdown` |
+| `generate-preview-images.sh` | `features/generate-preview-images` |
+| `install-preview-generator.sh` | `features/install-preview-generator` |
+
+## [0.8.2] - 2025-11-27
+
+### Changed
+
+- **Refactored: GitHub Actions Workflows** - Consolidated 5 workflows into 3 streamlined workflows
+  - Merged `auto-version-bump.yml` into `version-bump.yml` with both automatic and manual triggers
+  - Merged `gem-release.yml` and `github-release.yml` into unified `release.yml`
+  - Removed duplicate `quality` job from `ci.yml` (functionality retained in `quality-checks` job)
+  - Updated `ci.yml` build job to use `scripts/build` instead of deprecated `build.sh`
+
+- **Updated: Composite Action `prepare-release`** - Now uses `scripts/build` instead of deprecated `build.sh`
+
+### Added
+
+- **New Documentation: `.github/workflows/README.md`** - Comprehensive workflow documentation
+  - Workflow trigger flow diagram
+  - Job descriptions and timeout configurations
+  - Manual dispatch options and troubleshooting guide
+
+- **New Documentation: `.github/actions/README.md`** - Composite actions documentation
+  - Input/output specifications for all 5 actions
+  - Usage examples and best practices
+  - Action creation guide and troubleshooting
+
+### Removed
+
+- **Deleted: `auto-version-bump.yml`** - Functionality merged into `version-bump.yml`
+- **Deleted: `gem-release.yml`** - Functionality merged into `release.yml`
+- **Deleted: `github-release.yml`** - Functionality merged into `release.yml`
+- **Deleted: Deprecated wrapper scripts** - `build.sh`, `gem-publish.sh`, `release.sh` and their `.legacy` versions
+  - These were deprecated redirects to the new modular commands (`scripts/build`, `scripts/release`)
+
 ## [0.8.1] - 2025-11-27
 
 ### Added
@@ -48,7 +325,7 @@
   - One-command remote installation for other Jekyll sites
 - **New Plugin: `_plugins/preview_image_generator.rb`** - Jekyll integration with:
   - Liquid filters: `has_preview_image`, `preview_image_path`, `preview_filename`
-  - Liquid tags: `{% preview_image_status %}`, `{% preview_images_missing %}`
+  - Liquid tags: {% raw %}`{% preview_image_status %}`, `{% preview_images_missing %}`{% endraw %}
   - Build hook that reports missing preview images during Jekyll build
 - **New Script: `scripts/generate-preview-images.sh`** - Main CLI for image generation
   - `--list-missing` to find posts without preview images
@@ -145,6 +422,7 @@
 ## [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
@@ -154,6 +432,7 @@
 - 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
@@ -162,6 +441,7 @@
 - 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
@@ -173,8 +453,6 @@
 - 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/),
@@ -183,17 +461,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [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
@@ -208,16 +489,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - 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
@@ -228,6 +512,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [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 content pieces, categories, tags, and word counts
@@ -249,6 +534,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Smooth scroll navigation and fade-in animations for modern UX
 
 ### Changed
+
 - **📈 Activity Level Intelligence**: Dynamic threshold calculation replacing static values
   - Categories: High activity (≥70% of max), Medium (≥40% of max), Low (remainder)
   - Tags: Frequently used (≥60% of max), Moderately used (≥20% of max), Occasionally used (remainder)
@@ -259,6 +545,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Optimized data processing without complex sorting operations
 
 ### Fixed
+
 - **🐛 Data Display Issues**: Resolved template rendering and data access problems
   - Fixed Liquid template syntax errors causing empty displays
   - Corrected data structure references across all components
@@ -270,6 +557,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [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
@@ -288,11 +576,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - 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
@@ -302,27 +592,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.2.1] - 2025-09-30
 
 ### Added
+
 - Enhanced markdown linting configuration
 - Improved Jekyll template support for link checking
 - Better configuration for markdown validation
 
 ### Changed
+
 - Updated markdown-link-check configuration with Jekyll-specific patterns
 - Relaxed line length requirements in markdownlint configuration
 - Added support for more HTML elements in markdown
 
 ### Fixed
+
 - Improved markdown validation for Jekyll projects
 - Better handling of Liquid templates in link validation
 
 ## [0.2.0] - 2025-09-01
 
 ### Changed
+
 - Version bump to 0.2.0 with improvements
 
 ## [0.1.9] - 2025-01-27
 
 ### Added
+
 - **🐳 Docker-First Development Evolution**: Complete transformation to containerized development
   - AI-powered `init_setup.sh` with intelligent environment detection and auto-healing
   - Cross-platform Docker Compose configuration with Apple Silicon optimization
@@ -341,12 +636,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - AI-generated documentation and setup instructions
 
 ### Changed
+
 - **🔧 Installation Philosophy**: Shifted from traditional Ruby/Jekyll setup to Docker-first approach
   - Disabled local theme dependencies to avoid gemspec issues
   - Optimized for containerized development environments
   - Enhanced cross-platform compatibility and consistency
 
 ### Fixed
+
 - **🐛 Theme Dependency Issues**: Resolved Jekyll theme not found errors
   - Commented out problematic Jekyll includes in README.md
   - Disabled `remote_theme` in development configuration
@@ -359,6 +656,7 @@ 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
   - Zero-click releases with multi-environment testing
   - Production-ready CI/CD pipeline with GitHub Actions integration
@@ -371,6 +669,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Cleanup Functions**: Automatic cleanup of temporary files after remote installation
 
 ### Changed
+
 - **Feature Documentation Restructure**: Consolidated redundant automation feature entries
 - **Simplified Installation Process**: Updated to use single install command
 - **Azure-Ready Configuration**: Pre-configured directory structure for Azure Static Web Apps
@@ -378,9 +677,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Improved Help System**: Added remote installation examples
 
 ### Removed
+
 - **Redundant Documentation**: Eliminated duplicate automation documentation files
 
 ### Fixed
+
 - **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
@@ -388,6 +689,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.7] - 2024-12-01
 
 ### Added
+
 - Bootstrap Jekyll theme for headless GitHub Pages CMS
 - Basic theme structure with layouts, includes, and assets
 - Jekyll compatibility with GitHub Pages
@@ -396,6 +698,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Makefile for simplified command access
 
 ### Changed
+
 - Initial theme implementation and project structure
 
 ---
@@ -403,6 +706,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## 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
@@ -419,4 +723,4 @@ For detailed documentation on features, systems, and configuration:
 [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
+[0.1.7]: https://github.com/bamr87/zer0-mistakes/releases/tag/v0.1.7