jekyll-theme-zer0 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c1f84062f41461c980a5bbe9e83cc78e3e657ae3ba2de736b2931968c12fa2c
-  data.tar.gz: ea7b72031d159cbe9057fef78236cea13d465e21de1040365ae1ce47b5dc7ea5
+  metadata.gz: 82d722f8c9249249da9634e5e774dddda47d6ae3888e60e8f87269d697fc2752
+  data.tar.gz: 54c07e714da9f2e718f1c057354745adb0b1490562052d3ffec0a4fcf125430d
 SHA512:
-  metadata.gz: 2c45b5836e177461322d1b8b6a39dcd2e7c3437ddf16fda51fdd162a3ab02e8e6584e893d19e336f3c9c313cef23d70ce09c3fce8c78949efb71d83baca0533b
-  data.tar.gz: 28b475ad13770cf989d285d3ad1cd73c63216609734c356e312a8c0c62dfdd67a16f09d07e1cf0be5878b198a752d1965bfbe4ca78021707e20e7cb8c7efaff7
+  metadata.gz: a85d20e56b617f547beeee6e9d12571f110e606bf85e68c5773830d9ecc7f9b24c7d632f326db902792a7bf507ef3bb5eead8faff40a659112b481414293c13e
+  data.tar.gz: de2aa109131a6067d6ae045992ebca0fb0eb31cf048b336516aa426a3ab46be58d7d51b979923431bb4a8f0f42e73b110b5a60192ea094ec82ebbdf6afa14441

data/CHANGELOG.md

@@ -1,5 +1,89 @@
 # Changelog
 
+## [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
+- Version bump: patch release
+
+### 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
+-  update test runner documentation for Bash 3.2 compatibility
+-  update version to 0.15.0 and enhance documentation with new features
+
+### Fixed
+-  refactor changelog.sh for Bash 3.2 compatibility (macOS default)
+
+### Other
+-  document Bash 3.2 compatibility in automation
+-  unfreeze bundler before updating Gemfile.lock in version-bump workflow
+-  update Windows Developer Mode instructions and correct spelling errors
+-  Social sharing buttons use production URLs instead of localhost
+-  update Gemfile.lock for v0.15.0
+
+
+
 ## [0.15.0] - 2025-12-11
 
 ### Added

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.11.0
+version: 0.15.0
 layout: landing
 tags:
   - jekyll
@@ -215,12 +215,14 @@ pie title Technology Distribution
 
 | Layer | Technology | Purpose |
 |-------|-----------|---------|
-| **Framework** | Jekyll 3.9.5 | Static site generation |
+| **Framework** | Jekyll 3.10.0 | Static site generation |
 | **Styling** | Bootstrap 5.3.3 | Responsive UI components |
+| **Icons** | Bootstrap Icons | Unified iconography |
 | **Development** | Docker | Cross-platform consistency |
 | **Templates** | Liquid | Dynamic content rendering |
 | **Analytics** | PostHog | Privacy-first tracking |
 | **Diagrams** | Mermaid 10+ | Documentation visuals |
+| **Navigation** | Intersection Observer | Scroll spy & accessibility |
 
 ---
 
@@ -330,6 +332,33 @@ collections:
     permalink: /notebooks/:name/
 ```
 
+### 🧭 Enhanced Navigation System (v0.14.0)
+
+Modern, accessible sidebar navigation with advanced features:
+
+- **Intersection Observer Scroll Spy**: 70% reduction in scroll event overhead
+- **Keyboard Shortcuts**: `[` and `]` for section navigation
+- **Swipe Gestures**: Mobile-friendly left/right edge detection
+- **Skip-to-Content**: Accessibility-first WCAG 2.1 Level AA compliant
+- **Mobile TOC FAB**: Floating action button for table of contents
+- **Unified Bootstrap Icons**: Consistent iconography across all components
+- **Focus Management**: Improved screen reader support with ARIA labels
+
+| Shortcut | Action |
+|----------|--------|
+| `[` | Previous section |
+| `]` | Next section |
+| `Tab` | Skip to content |
+| Swipe | Toggle sidebar (mobile) |
+
+### 📋 Legal & Compliance Pages (v0.15.0)
+
+Built-in GDPR/CCPA compliant documentation:
+
+- **Privacy Policy**: Comprehensive data collection transparency
+- **Terms of Service**: Ready-to-customize legal framework
+- **Cookie Consent**: Granular user preference management
+
 ---
 
 ## 📦 Installation Methods
@@ -361,7 +390,7 @@ docker-compose up
 
 ```ruby
 # Gemfile
-gem "jekyll-theme-zer0", "~> 0.10"
+gem "jekyll-theme-zer0", "~> 0.15"
 ```
 
 ---
@@ -403,12 +432,13 @@ graph TD
 
 | Directory | Purpose | Key Files |
 |-----------|---------|-----------|
-| `_layouts/` | Page templates | `default.html`, `journals.html`, `landing.html` |
-| `_includes/` | Reusable components | `core/`, `components/`, `analytics/` |
-| `_sass/` | Stylesheets | `custom.scss`, `core/` |
-| `assets/` | Static files | `css/`, `js/`, `images/` |
-| `scripts/` | Automation | `release`, `build`, `version.sh` |
-| `docs/` | Technical docs | `features/`, `systems/`, `releases/` |
+| `_layouts/` | Page templates | `default.html`, `journals.html`, `landing.html`, `notebook.html` |
+| `_includes/` | Reusable components | `core/`, `components/`, `analytics/`, `navigation/` |
+| `_sass/` | Stylesheets | `custom.scss`, `notebooks.scss`, `core/` |
+| `assets/` | Static files | `css/`, `js/sidebar.js`, `images/` |
+| `scripts/` | Automation | `release`, `build`, `convert-notebooks.sh` |
+| `docs/` | Technical docs | `SIDEBAR_IMPROVEMENTS.md`, `JUPYTER_NOTEBOOKS.md` |
+| `pages/` | Content pages | `privacy-policy.md`, `terms-of-service.md` |
 
 ---
 
@@ -537,8 +567,10 @@ graph LR
 | [📋 Technical Docs](docs/) | Architecture, systems, implementation |
 | [📖 User Guides](pages/_docs/) | Published tutorials and references |
 | [🤖 Copilot Instructions](.github/copilot-instructions.md) | AI development guidelines |
-| [🌱 Seed Documentation](.github/seed/) | Full reconstruction blueprints |
+| [⌨️ Keyboard Navigation](docs/keyboard-navigation.md) | Accessibility shortcuts guide |
+| [📓 Jupyter Notebooks](docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
 | [📝 PRD](PRD.md) | Product requirements & roadmap |
+| [🔒 Privacy Policy](pages/privacy-policy.md) | GDPR/CCPA compliant privacy docs |
 
 ---
 
@@ -582,9 +614,9 @@ flowchart LR
 /opt/homebrew/bin/bash scripts/release patch --dry-run
 
 # Full release
-/opt/homebrew/bin/bash scripts/release patch  # 0.10.3 → 0.10.4
-/opt/homebrew/bin/bash scripts/release minor  # 0.10.3 → 0.11.0
-/opt/homebrew/bin/bash scripts/release major  # 0.10.3 → 1.0.0
+/opt/homebrew/bin/bash scripts/release patch  # 0.15.0 → 0.15.1
+/opt/homebrew/bin/bash scripts/release minor  # 0.15.0 → 0.16.0
+/opt/homebrew/bin/bash scripts/release major  # 0.15.0 → 1.0.0
 ```
 
 ---
@@ -596,19 +628,19 @@ gantt
     title zer0-mistakes Roadmap
     dateFormat YYYY-MM
     section Current
-    v0.10.x Maintenance       :done, 2025-11, 2025-12
+    v0.15.x Maintenance       :done, 2025-12, 2026-01
     section Future
-    v0.11 - CMS Integration   :2026-01, 2026-03
-    v0.12 - Advanced Analytics:2026-04, 2026-06
-    v0.13 - i18n Support      :2026-07, 2026-09
+    v0.16 - CMS Integration   :2026-01, 2026-03
+    v0.17 - Advanced Analytics:2026-04, 2026-06
+    v0.18 - i18n Support      :2026-07, 2026-09
     v1.0 - Production Ready   :milestone, 2027-01, 1d
 ```
 
 | Version | Target | Features |
 |---------|--------|----------|
-| **v0.11** | Q1 2026 | Headless CMS integration, content API |
-| **v0.12** | Q2 2026 | A/B testing, conversion funnels |
-| **v0.13** | Q3 2026 | Multi-language support (i18n) |
+| **v0.16** | Q1 2026 | Headless CMS integration, content API |
+| **v0.17** | Q2 2026 | A/B testing, conversion funnels |
+| **v0.18** | Q3 2026 | Multi-language support (i18n) |
 | **v1.0** | Q1 2027 | Stable API, 90%+ test coverage |
 
 ---
@@ -664,11 +696,11 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 0.10.3 |
+| **Current Version** | 0.15.0 |
 | **Installation Success** | ~95% |
 | **Setup Time** | 2-5 minutes |
-| **RubyGems Downloads** | 2,500+ |
-| **Documentation** | 17,500+ lines |
+| **RubyGems Downloads** | 3,000+ |
+| **Documentation** | 20,000+ lines |
 | **Lighthouse Score** | 95+ |
 
 ---
@@ -688,6 +720,6 @@ Built with these amazing technologies:
 
 **Built with ❤️ for the Jekyll community**
 
-**v0.10.3** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
+**v0.15.0** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)