jekyll-theme-zer0 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82d722f8c9249249da9634e5e774dddda47d6ae3888e60e8f87269d697fc2752
-  data.tar.gz: 54c07e714da9f2e718f1c057354745adb0b1490562052d3ffec0a4fcf125430d
+  metadata.gz: cedad3b535f19c489e0d874be9c116789f981fc042743150be32b06f7d6481c7
+  data.tar.gz: 0cd8445680be5c73980338a85aba69a8edb5e9484003fd74daf80c104690e22d
 SHA512:
-  metadata.gz: a85d20e56b617f547beeee6e9d12571f110e606bf85e68c5773830d9ecc7f9b24c7d632f326db902792a7bf507ef3bb5eead8faff40a659112b481414293c13e
-  data.tar.gz: de2aa109131a6067d6ae045992ebca0fb0eb31cf048b336516aa426a3ab46be58d7d51b979923431bb4a8f0f42e73b110b5a60192ea094ec82ebbdf6afa14441
+  metadata.gz: 35520e071daded7969373b51f103d8a8440db28b03044ca1db0c01832d676cbcfc32d677d285ce612c8f79a6a2fa2fa8023570457a28cba83615fea8363bd1eb
+  data.tar.gz: 654aa816eeb3b3e1019f0686eb2516eb4404e17ad4e533f764d32240fd1454a6c893a6e376fb907387b0a5f3cd514c1e364b365df92ed07e1279a90144ffc222

data/CHANGELOG.md

@@ -1,5 +1,79 @@
 # 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
@@ -64,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
@@ -1104,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
 
@@ -1149,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
 
@@ -1184,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
 
@@ -1304,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: