jekyll-theme-zer0 0.15.0 → 0.15.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c1f84062f41461c980a5bbe9e83cc78e3e657ae3ba2de736b2931968c12fa2c
-  data.tar.gz: ea7b72031d159cbe9057fef78236cea13d465e21de1040365ae1ce47b5dc7ea5
+  metadata.gz: 62704de5aed76c7000c418b93977002ded56b588a49183c4548c315bd2b40fdd
+  data.tar.gz: acfd3a0d47a33a99af964fe2019e0128bbfb50903640658671bb6090b3b38495
 SHA512:
-  metadata.gz: 2c45b5836e177461322d1b8b6a39dcd2e7c3437ddf16fda51fdd162a3ab02e8e6584e893d19e336f3c9c313cef23d70ce09c3fce8c78949efb71d83baca0533b
-  data.tar.gz: 28b475ad13770cf989d285d3ad1cd73c63216609734c356e312a8c0c62dfdd67a16f09d07e1cf0be5878b198a752d1965bfbe4ca78021707e20e7cb8c7efaff7
+  metadata.gz: 8db972fbd75ed902880434ab1e8a79ba24ae276492cebce8987cda3ad085b0aeea26fc2174e8cf72594896884c5d1b3b08f816b97a0d1536044d51afa52c2d5e
+  data.tar.gz: 839bbeb76675da98c6136c952722154249264fe4998003b4c5e2152401855dcea16ac31864f89e66a30236589e41ecc789361378fd3308a8c529cd8315c67a0f

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [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)
 
 

data/_data/README.md

@@ -1,31 +1,433 @@
-## Getting Started
+# 📊 Zer0-Mistakes Data Directory
 
-These instructions will help you understand the data files in this directory.
+This directory contains YAML data files that power the Zer0-Mistakes Jekyll theme's dynamic features, including navigation, content statistics, internationalization, and content organization.
 
-### Raw Data
+## 📁 Directory Contents
 
-The `raw` directory contains the raw data files. These files are the original data and have not been processed or manipulated in any way.
+| File | Purpose | Auto-Generated |
+|------|---------|----------------|
+| `navigation/` | Site navigation menus | No |
+| `authors.yml` | Author profile information | No |
+| `content_statistics.yml` | Site content analytics | **Yes** |
+| `statistics_config.yml` | Statistics generation config | No |
+| `ui-text.yml` | Multilingual UI text labels | No |
+| `prerequisites.yml` | Educational prerequisites | No |
+| `posts_organization.yml` | Post section mappings | No |
+| `generate_statistics.rb` | Statistics generator script | No |
+| `generate_statistics.sh` | Bash wrapper script | No |
+| `update_statistics.sh` | CI/CD automation script | No |
+| `github-actions-example.yml` | Example workflow | No |
 
-### Processed Data
+---
 
-The `processed` directory contains the data files that have been processed and are ready for analysis. These files have been cleaned, manipulated, or otherwise processed from the raw data files.
+## 📂 Navigation
 
-## Contributing
+### `navigation/`
 
-Please read [CONTRIBUTING.md](url) for details on our code of conduct, and the process for submitting pull requests to us.
+Contains YAML files for site navigation menus (sidebar, header, footer).
 
-## Authors
+**Example structure:**
+```yaml
+# navigation/main.yml
+- title: Home
+  url: /
+  icon: bi-house
+- title: Documentation
+  url: /docs/
+  icon: bi-book
+  children:
+    - title: Getting Started
+      url: /docs/getting-started/
+```
 
-- **Your Name** - _Initial work_ - [YourGithub](url)
+---
 
-See also the list of [contributors](url) who participated in this project.
+## 👤 Authors
 
-## License
+### `authors.yml`
 
-This project is licensed under the MIT License - see the [LICENSE.md](url) file for details
+Defines author profiles for multi-author sites.
 
-## Acknowledgments
+**Structure:**
+```yaml
+john_doe:
+  name: "John Doe"
+  bio: "Senior Developer and Technical Writer"
+  avatar: /assets/images/authors/john.jpg
+  email: john@example.com
+  twitter: johndoe
+  github: johndoe
+  website: https://johndoe.dev
+```
 
-- Hat tip to anyone whose code was used
-- Inspiration
-- etc
+**Usage in posts:**
+```yaml
+---
+author: john_doe
+---
+```
+
+---
+
+## 📈 Content Statistics
+
+### `content_statistics.yml` ⚡ *Auto-Generated*
+
+Contains computed statistics about site content. **Do not edit manually** - this file is regenerated by `generate_statistics.rb`.
+
+**Generated metrics:**
+- `total_posts`: Total number of posts
+- `published`: Published posts count
+- `drafts`: Draft posts count
+- `categories`: Posts per category
+- `category_count`: Total unique categories
+- `tags`: Posts per tag
+- `tag_count`: Total unique tags
+- `focus_areas`: Content by focus area (DevOps, Frontend, etc.)
+- `skill_levels`: Content by difficulty level
+- `content_types`: Content by type (tutorial, guide, etc.)
+- `authors`: Posts per author
+- `content_freshness`: Age distribution of content
+- `date_range`: Earliest and latest post dates
+- `derived_stats`: Calculated averages and insights
+- `generated_at`: Timestamp of generation
+
+**Accessing in templates:**
+```liquid
+{% assign stats = site.data.content_statistics %}
+<p>Total posts: {{ stats.total_posts }}</p>
+<p>Most posts in: {{ stats.derived_stats.most_common_category }}</p>
+```
+
+### `statistics_config.yml`
+
+Configuration for the statistics generator. Defines keyword mappings for content analysis.
+
+**Sections:**
+```yaml
+# Focus area detection keywords
+focus_areas:
+  devops: [docker, kubernetes, ci/cd, jenkins, terraform]
+  frontend: [javascript, react, vue, css, html]
+  backend: [python, node, api, database, sql]
+  # ... more areas
+
+# Skill level detection
+skill_levels:
+  beginner: [introduction, basics, getting started, 101]
+  intermediate: [advanced basics, building, implementing]
+  advanced: [optimization, architecture, scaling]
+  expert: [mastering, deep dive, internals]
+
+# Content type detection
+content_types:
+  tutorial: [tutorial, how-to, step-by-step, walkthrough]
+  guide: [guide, handbook, manual, reference]
+  # ... more types
+
+# Display preferences
+display:
+  top_categories: 10
+  top_tags: 20
+  top_focus_areas: 8
+```
+
+---
+
+## 🔧 Statistics Scripts
+
+### `generate_statistics.rb`
+
+Ruby script that analyzes site content and generates `content_statistics.yml`.
+
+**Usage:**
+```bash
+# Direct execution
+ruby _data/generate_statistics.rb
+
+# Via wrapper script
+bash _data/generate_statistics.sh
+```
+
+**Features:**
+- Front matter parsing
+- Category and tag analysis
+- Focus area detection (via keywords)
+- Skill level classification
+- Content freshness calculation
+- Author statistics
+- Derived metrics computation
+
+### `generate_statistics.sh`
+
+Bash wrapper script for statistics generation with validation and preview.
+
+**Usage:**
+```bash
+# Generate statistics
+./generate_statistics.sh
+
+# Preview output (requires yq)
+./generate_statistics.sh --preview
+```
+
+**Features:**
+- Ruby availability check
+- Configuration file validation
+- Content directory verification
+- Color-coded output
+- Optional preview with yq
+
+### `update_statistics.sh`
+
+CI/CD automation script for running statistics updates in pipelines.
+
+**Environment Variables:**
+```bash
+CI=true          # Indicates CI environment
+AUTO_PUSH=true   # Auto-commit and push changes
+FORCE_UPDATE=true # Skip hash comparison
+```
+
+**Features:**
+- CI environment detection
+- Hash-based change detection
+- Automatic git commit/push
+- Skip unchanged content
+- Detailed logging
+
+### `github-actions-example.yml`
+
+Example GitHub Actions workflow for automated statistics updates.
+
+**Copy to `.github/workflows/update-statistics.yml` to enable.**
+
+**Triggers:**
+- Push to `pages/_posts/**`, `pages/_docs/**`, `_data/statistics_config.yml`
+- Manual workflow_dispatch with options
+- Weekly schedule (Monday 6 AM UTC)
+
+**Workflow Options:**
+- `force_update`: Update even if no changes detected
+- `skip_push`: Generate but don't commit
+
+---
+
+## 🌐 Internationalization (i18n)
+
+### `ui-text.yml`
+
+Multilingual UI text labels for theme components.
+
+**Supported Languages:**
+- `en` - English (default)
+- `es` - Spanish
+- `fr` - French
+- `de` - German
+- `ar` - Arabic (RTL)
+
+**Structure:**
+```yaml
+en:
+  # Navigation
+  skip_links: "Skip to main content"
+  menu_label: "Menu"
+  search_label: "Search"
+  
+  # Content
+  read_more: "Read more"
+  table_of_contents: "Table of Contents"
+  
+  # Statistics
+  stats_total_posts: "Total Posts"
+  stats_published: "Published"
+  # ... more labels
+```
+
+**Usage in templates:**
+```liquid
+{% assign ui = site.data.ui-text[site.lang | default: 'en'] %}
+<span>{{ ui.read_more }}</span>
+```
+
+---
+
+## 📚 Educational Content
+
+### `prerequisites.yml`
+
+Defines prerequisites for tutorials and educational content.
+
+**Structure:**
+```yaml
+- id: git-basics
+  title: "Git Version Control Basics"
+  description: "Understanding commits, branches, and basic git workflow"
+  level: beginner
+  category: version-control
+  
+- id: docker-fundamentals
+  title: "Docker Container Fundamentals"
+  description: "Understanding containers, images, and Docker CLI"
+  level: intermediate
+  category: devops
+```
+
+**Usage in post front matter:**
+```yaml
+---
+prerequisites:
+  - git-basics
+  - docker-fundamentals
+---
+```
+
+**Usage in templates:**
+```liquid
+{% if page.prerequisites %}
+<div class="prerequisites">
+  <h4>Prerequisites</h4>
+  <ul>
+  {% for prereq_id in page.prerequisites %}
+    {% assign prereq = site.data.prerequisites | where: "id", prereq_id | first %}
+    <li>{{ prereq.title }} - {{ prereq.description }}</li>
+  {% endfor %}
+  </ul>
+</div>
+{% endif %}
+```
+
+---
+
+## 📂 Post Organization
+
+### `posts_organization.yml`
+
+Configuration for post section mappings and URL patterns.
+
+**Sections:**
+```yaml
+sections:
+  - id: ai-machine-learning
+    title: "AI & Machine Learning"
+    directory: "pages/_posts/ai & machine learning"
+    icon: "bi-robot"
+    color: "#8B5CF6"
+    description: "Artificial intelligence, ML models, and data science"
+    aliases: ["ai", "ml", "machine-learning", "artificial-intelligence"]
+```
+
+**Category to Section Mapping:**
+```yaml
+category_to_section:
+  "ai & machine learning": ai-machine-learning
+  "artificial intelligence": ai-machine-learning
+  "devops": devops
+  "docker": devops
+```
+
+**URL Pattern:**
+```yaml
+url_pattern: "/:categories/:year/:month/:day/:title/"
+```
+
+---
+
+## 🔄 Automation Workflows
+
+### Setting Up Automated Statistics
+
+1. **Copy the workflow file:**
+   ```bash
+   cp _data/github-actions-example.yml .github/workflows/update-statistics.yml
+   ```
+
+2. **Ensure scripts are executable:**
+   ```bash
+   chmod +x _data/generate_statistics.sh
+   chmod +x _data/update_statistics.sh
+   ```
+
+3. **Customize triggers** in the workflow file as needed.
+
+4. **Push to main branch** to enable the workflow.
+
+### Manual Statistics Update
+
+```bash
+# From repository root
+cd _data
+ruby generate_statistics.rb
+
+# Or using the wrapper
+bash generate_statistics.sh
+```
+
+---
+
+## 🛠️ Customization
+
+### Adding New Focus Areas
+
+Edit `statistics_config.yml`:
+```yaml
+focus_areas:
+  my_new_area:
+    - keyword1
+    - keyword2
+    - keyword3
+```
+
+### Adding New Languages
+
+Add a new language block to `ui-text.yml`:
+```yaml
+ja:  # Japanese
+  skip_links: "メインコンテンツへスキップ"
+  menu_label: "メニュー"
+  # ... translate all labels
+```
+
+### Adding New Prerequisites
+
+Edit `prerequisites.yml`:
+```yaml
+- id: my-prerequisite
+  title: "My New Prerequisite"
+  description: "Description of what this covers"
+  level: beginner  # beginner|intermediate|advanced|expert
+  category: my-category
+```
+
+---
+
+## 📋 Best Practices
+
+1. **Never edit `content_statistics.yml` manually** - it will be overwritten
+2. **Keep `statistics_config.yml` updated** when adding new content types
+3. **Test configuration changes locally** before pushing
+4. **Use consistent language codes** in `ui-text.yml`
+5. **Keep prerequisite IDs kebab-case** for URL friendliness
+6. **Validate YAML syntax** before committing:
+   ```bash
+   ruby -ryaml -e "YAML.load_file('_data/your-file.yml')"
+   ```
+
+---
+
+## 🤝 Contributing
+
+When modifying data files:
+
+1. Follow existing YAML formatting conventions
+2. Test changes locally with `bundle exec jekyll serve`
+3. Run statistics generation to verify no errors
+4. Update this README if adding new files or features
+
+See [CONTRIBUTING.md](../CONTRIBUTING.md) for full guidelines.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](../LICENSE) file for details.