jekyll-theme-zer0 0.15.2 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62704de5aed76c7000c418b93977002ded56b588a49183c4548c315bd2b40fdd
-  data.tar.gz: acfd3a0d47a33a99af964fe2019e0128bbfb50903640658671bb6090b3b38495
+  metadata.gz: cedad3b535f19c489e0d874be9c116789f981fc042743150be32b06f7d6481c7
+  data.tar.gz: 0cd8445680be5c73980338a85aba69a8edb5e9484003fd74daf80c104690e22d
 SHA512:
-  metadata.gz: 8db972fbd75ed902880434ab1e8a79ba24ae276492cebce8987cda3ad085b0aeea26fc2174e8cf72594896884c5d1b3b08f816b97a0d1536044d51afa52c2d5e
-  data.tar.gz: 839bbeb76675da98c6136c952722154249264fe4998003b4c5e2152401855dcea16ac31864f89e66a30236589e41ecc789361378fd3308a8c529cd8315c67a0f
+  metadata.gz: 35520e071daded7969373b51f103d8a8440db28b03044ca1db0c01832d676cbcfc32d677d285ce612c8f79a6a2fa2fa8023570457a28cba83615fea8363bd1eb
+  data.tar.gz: 654aa816eeb3b3e1019f0686eb2516eb4404e17ad4e533f764d32240fd1454a6c893a6e376fb907387b0a5f3cd514c1e364b365df92ed07e1279a90144ffc222

data/CHANGELOG.md

@@ -1,5 +1,135 @@
 # Changelog
 
+## [0.17.0] - 2025-12-23
+
+### Added
+- **Navbar Hover Dropdowns**: Desktop users can now hover over navigation items to reveal sub-menus with smooth fade transitions
+- **ES6 Navigation Modules**: Complete rewrite of navigation JavaScript using native ES6 modules (`type="module"`)
+  - `config.js` - Centralized configuration with CSS custom properties
+  - `scroll-spy.js` - Table of contents highlighting
+  - `smooth-scroll.js` - Animated scrolling to anchors
+  - `keyboard.js` - Full keyboard navigation support
+  - `gestures.js` - Touch gesture support for mobile
+  - `focus.js` - Focus management and accessibility
+  - `sidebar-state.js` - Persistent expand/collapse state
+  - `index.js` - Module orchestration and initialization
+- **Nav Tree Component**: New `_includes/navigation/nav-tree.html` for rendering hierarchical YAML navigation (2 levels deep)
+- **Navigation Schema Documentation**: Added `_data/navigation/README.md` with complete schema definition
+- **Migration Script**: Added `scripts/migrate-nav-modes.sh` to update front matter from old to new nav modes
+
+### Changed
+- **Navigation YAML Schema**: Standardized on `children` key (previously `sublinks`) across all navigation files
+- **Navigation Modes**: Simplified to 3 standard modes:
+  - `auto` - Auto-generates from collection documents (replaces `dynamic`)
+  - `tree` - Uses YAML data files for hierarchical navigation
+  - `categories` - Groups content by Jekyll categories (replaces `searchCats`)
+- **Sidebar Component**: Refactored `_includes/navigation/sidebar-left.html` to use new nav modes
+- **Script Loading**: Updated `_includes/components/js-cdn.html` to use `type="module"` for ES6 modules
+- **Default Collection Config**: Updated `_config.yml` with new navigation mode defaults
+
+### Removed
+- **Legacy sidebar.js**: Deleted 512-line IIFE-based sidebar script, replaced by modular ES6 architecture
+
+### Fixed
+- **Mobile Dropdown Behavior**: Fixed glitch where opening one dropdown would close others; each now operates independently
+- **Dropdown Positioning**: Fixed desktop hover dropdowns appearing on top of parent links (now correctly appear below)
+
+## [0.16.3] - 2025-01-27
+
+### Changed
+- **Documentation Navigation**: Restructured `_data/navigation/docs.yml` with logical sections (Getting Started, Core Technologies, Theme Features, Deployment)
+- **Main Navigation**: Updated `_data/navigation/main.yml` with expanded Docs dropdown entries (Documentation Home, Installation, Docker, Troubleshooting)
+
+### Fixed
+- **Liquid Syntax Error**: Fixed pre-existing bug in `pages/features.md` where `where_exp` filters used unsupported `or` conditions (Liquid 4.x compatibility)
+
+### Documentation
+- **Installation Guide**: Expanded with platform-specific guides (macOS, Windows, Linux), Docker quick start, verification steps
+- **Docker Guide**: Added essential commands, container workflows, configuration files, Apple Silicon support, troubleshooting
+- **Troubleshooting Guide**: Added sections for Docker issues, Jekyll build errors, front matter problems, performance optimization
+- **Jekyll Guide**: Added directory structure, configuration files, content collections, essential commands, topic index
+- **Bootstrap Guide**: Added CDN loading patterns, key components, responsive breakpoints, custom styles, icons
+- **Liquid Guide**: Added syntax examples with `{% raw %}` tags, filters, control flow, includes
+- **Ruby Guide**: Added version commands, common commands, key files, Docker usage, troubleshooting
+- **Front Matter Guide**: Added required/optional fields, layout options, collection-specific fields, complete examples
+- All documentation pages now include `sidebar: nav: docs` for consistent navigation
+
+## [0.16.2] - 2025-12-20
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 2a0057e Comprehensive features.yml with references, documentation, and showcase page (#17)
+
+
+## [0.16.1] - 2025-12-20
+
+### Changed
+- Hardened CI workflows with least-privilege `permissions` and `concurrency`
+- Updated landing/repo links to render correctly with YAML-array URL config
+- Excluded repo technical `docs/` from the published site build (GitHub links used instead)
+
+### Fixed
+- Removed false-green behavior in `test-latest.yml` (RSpec/HTMLProofer now fail the workflow)
+- Fixed broken internal links/hashes and aligned navigation anchors (strict HTMLProofer-compatible)
+
+## [0.16.0] - 2025-12-20
+
+### Added
+- **Configurable Assets Prefix**: New `assets_prefix` and `auto_prefix` configuration options for preview images
+  - Allows shorter frontmatter paths like `/images/previews/image.png` instead of `/assets/images/previews/image.png`
+  - Automatic path normalization in Liquid templates detects external URLs vs local paths
+  - Configured via `_config.yml` under `preview_images.assets_prefix` and `preview_images.auto_prefix`
+- **xAI Grok Image Provider**: Added xAI as a new AI provider for preview image generation
+  - Uses `grok-2-image` model at `https://api.x.ai/v1/images/generations`
+  - Set `XAI_API_KEY` environment variable and use `--provider xai` flag
+- **Preview Path Migration Script**: New `scripts/update-preview-paths.sh` for migrating existing frontmatter
+  - Supports dry-run and apply modes
+  - Removes `/assets/` prefix from preview paths in markdown files
+
+### Changed
+- Updated `preview-image.html` include with path normalization logic
+- Updated `intro.html` include with assets prefix support for hero backgrounds
+- Updated `seo.html` include with assets prefix normalization for og:image meta tags
+- Enhanced `preview_image_generator.rb` Ruby plugin with `normalize_preview_path` method
+- Enhanced `preview_generator.py` with xAI provider, `--assets-prefix`, and `--no-auto-prefix` CLI options
+- Migrated 24 markdown files to use shorter preview paths (without `/assets/` prefix)
+- Updated scripts/README.md documentation with new provider and prefix options
+
+### Fixed
+- **Critical: Liquid syntax error in `seo.html`** - Fixed invalid nested curly braces on line 27
+
+## [0.15.5] - 2025-12-20
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- d46cdb1 Merge branch 'main' of https://github.com/bamr87/zer0-mistakes
+- 36767cd fix: update last modified timestamp in quick start guide
+- f606096 fix: update quick start guide for clarity and consistency
+
+
+## [0.15.4] - 2025-12-20
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- bafb5ea fix: resolve CI quality check failures for preview images
+
+
+## [0.15.3] - 2025-12-20
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 2f8b580 chore: merge branch and version bump to 0.15.2
+- a239892 chore: bump version to 0.15.2
+
+
 ## [0.15.2] - 2025-12-19
 
 ### Changed
@@ -8,8 +138,6 @@
 ### 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
@@ -1048,7 +1176,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **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)
+**Full Documentation**: [v0.5.0 Release Summary](https://github.com/bamr87/zer0-mistakes/blob/main/docs/releases/v0.5.0-release-summary.md)
 
 ## [0.4.0] - 2025-10-10
 
@@ -1093,7 +1221,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - 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)
+**Full Documentation**: [v0.4.0 Release Summary](https://github.com/bamr87/zer0-mistakes/blob/main/docs/releases/v0.4.0-release-summary.md)
 
 ## [0.3.0] - 2025-01-27
 
@@ -1128,7 +1256,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **⚡ 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)
+**Full Documentation**: [v0.3.0 Release Notes](https://github.com/bamr87/zer0-mistakes/blob/main/docs/releases/v0.3.0-release-notes.md)
 
 ## [0.2.1] - 2025-09-30
 
@@ -1248,11 +1376,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 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
+- **[Documentation Center](https://github.com/bamr87/zer0-mistakes/tree/main/docs)** - Complete documentation overview
+- **[Release Documentation](https://github.com/bamr87/zer0-mistakes/tree/main/docs/releases)** - Historical release information
+- **[Feature Documentation](https://github.com/bamr87/zer0-mistakes/tree/main/docs/features)** - Detailed feature guides
+- **[System Documentation](https://github.com/bamr87/zer0-mistakes/tree/main/docs/systems)** - Core systems and automation
+- **[Configuration Guides](https://github.com/bamr87/zer0-mistakes/tree/main/docs/configuration)** - Setup and configuration
 
 ## Links
 

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.15.0
+version: 0.16.1
 layout: landing
 tags:
   - jekyll
@@ -564,13 +564,13 @@ graph LR
 
 | Resource | Description |
 |----------|-------------|
-| [📋 Technical Docs](docs/) | Architecture, systems, implementation |
-| [📖 User Guides](pages/_docs/) | Published tutorials and references |
-| [🤖 Copilot Instructions](.github/copilot-instructions.md) | AI development guidelines |
-| [⌨️ Keyboard Navigation](docs/keyboard-navigation.md) | Accessibility shortcuts guide |
-| [📓 Jupyter Notebooks](docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
+| [📋 Technical Docs]({{ site.resources.github_repo | default: '' | join: '' }}/tree/{{ site.branch }}/docs/) | Architecture, systems, implementation |
+| [📖 User Guides]({{ '/docs/' | relative_url }}) | Published tutorials and references |
+| [🤖 Copilot Instructions]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/.github/copilot-instructions.md) | AI development guidelines |
+| [⌨️ Keyboard Navigation]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/docs/keyboard-navigation.md) | Accessibility shortcuts guide |
+| [📓 Jupyter Notebooks]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
 | [📝 PRD](PRD.md) | Product requirements & roadmap |
-| [🔒 Privacy Policy](pages/privacy-policy.md) | GDPR/CCPA compliant privacy docs |
+| [🔒 Privacy Policy]({{ '/privacy-policy/' | relative_url }}) | GDPR/CCPA compliant privacy docs |
 
 ---
 

data/_data/authors.yml

@@ -19,7 +19,7 @@
 default:
   name: "Zer0-Mistakes Team"
   bio: "The collective voice of the Zer0-Mistakes Jekyll theme development team."
-  avatar: "/images/default-avatar.png"
+  avatar: "/images/gravatar-small.png"
   github: "bamr87"
   website: "https://bamr87.github.io/zer0-mistakes/"
   role: "Development Team"
@@ -35,7 +35,7 @@ bamr87:
 guest:
   name: "Guest Author"
   bio: "A valued contributor to our community."
-  avatar: "/images/default-avatar.png"
+  avatar: "/images/gravatar-small.png"
   role: "Guest Contributor"
 
 # Add more authors as needed: