jekyll-theme-zer0 0.21.0 → 0.22.0

data/scripts/bin/build

@@ -83,7 +83,17 @@ main() {
     success "Environment validated"
     echo ""
     
-    # Step 2: Get current version
+    # Step 2: Vendor assets (optional refresh before packaging)
+    step "Vendor assets..."
+    local vendor_script="$SCRIPT_DIR/../vendor-install.sh"
+    if [[ -f "$vendor_script" ]]; then
+        bash "$vendor_script" || warn "vendor-install.sh exited non-zero; continuing build"
+    else
+        warn "vendor-install.sh not found, skipping"
+    fi
+    echo ""
+    
+    # Step 3: Get current version
     step "Reading version..."
     local version
     version=$(get_current_version)
@@ -91,7 +101,7 @@ main() {
     info "Gem file: jekyll-theme-zer0-${version}.gem"
     echo ""
     
-    # Step 3: Build gem
+    # Step 4: Build gem
     build_gem "$version"
     echo ""
     

data/scripts/lib/common.sh

@@ -108,6 +108,60 @@ require_file() {
     debug "Found required file: $file"
 }
 
+# Load simple KEY=VALUE pairs from an env file
+load_env_file() {
+    local env_file="$1"
+
+    if [[ ! -f "$env_file" ]]; then
+        return 0
+    fi
+
+    debug "Loading environment from $env_file"
+
+    while IFS= read -r line || [[ -n "$line" ]]; do
+        # Trim leading whitespace for easier parsing.
+        line="${line#"${line%%[![:space:]]*}"}"
+
+        [[ -z "$line" ]] && continue
+        [[ "$line" == \#* ]] && continue
+        [[ "$line" != *=* ]] && continue
+
+        local key="${line%%=*}"
+        local value="${line#*=}"
+
+        # Trim whitespace around key/value.
+        key="${key#"${key%%[![:space:]]*}"}"
+        key="${key%"${key##*[![:space:]]}"}"
+        value="${value#"${value%%[![:space:]]*}"}"
+        value="${value%"${value##*[![:space:]]}"}"
+
+        # Only export valid shell identifiers.
+        [[ "$key" =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] || continue
+
+        # Remove surrounding single/double quotes if present.
+        if [[ "$value" =~ ^\".*\"$ ]]; then
+            value="${value:1:${#value}-2}"
+        elif [[ "$value" =~ ^\'.*\'$ ]]; then
+            value="${value:1:${#value}-2}"
+        fi
+
+        export "$key=$value"
+    done < "$env_file"
+}
+
+# Prefer API-key auth from environment for RubyGems publish operations.
+prepare_rubygems_api_key() {
+    local repo_root
+    repo_root="$(get_repo_root)"
+
+    load_env_file "$repo_root/.env"
+
+    if [[ -z "${GEM_HOST_API_KEY:-}" ]] && [[ -n "${RUBY_API_KEY:-}" ]]; then
+        export GEM_HOST_API_KEY="$RUBY_API_KEY"
+        debug "Mapped RUBY_API_KEY to GEM_HOST_API_KEY for RubyGems publishing"
+    fi
+}
+
 # Get script directory
 get_script_dir() {
     local script_path="${BASH_SOURCE[0]}"
@@ -150,5 +204,6 @@ print_summary() {
 export -f log info step success warn error debug
 export -f confirm dry_run_exec
 export -f command_exists require_command require_file
+export -f load_env_file prepare_rubygems_api_key
 export -f get_script_dir get_repo_root
 export -f print_header print_summary

data/scripts/lib/gem.sh

@@ -101,6 +101,13 @@ publish_gem() {
     if [[ ! -f "$gem_file" ]]; then
         error "Gem file not found: $gem_file (run build first)"
     fi
+
+    # Load API-key auth from environment or .env before publish.
+    prepare_rubygems_api_key
+
+    if [[ -z "${GEM_HOST_API_KEY:-}" ]] && [[ ! -f ~/.gem/credentials ]]; then
+        error "RubyGems authentication missing. Set GEM_HOST_API_KEY (or RUBY_API_KEY in .env) or run 'gem signin'."
+    fi
     
     # Check if version already exists
     if gem_version_exists "$version"; then

data/scripts/lib/validation.sh

@@ -69,9 +69,17 @@ validate_rubygems_auth() {
     fi
     
     debug "Validating RubyGems authentication..."
+
+    # Load API key from environment or .env when available.
+    prepare_rubygems_api_key
+
+    if [[ -n "${GEM_HOST_API_KEY:-}" ]]; then
+        debug "✓ RubyGems API key available via GEM_HOST_API_KEY"
+        return 0
+    fi
     
     if [[ ! -f ~/.gem/credentials ]]; then
-        error "Not authenticated with RubyGems. Run 'gem signin' first."
+        error "RubyGems authentication missing. Set GEM_HOST_API_KEY (or RUBY_API_KEY in .env) or run 'gem signin'."
     fi
     
     debug "✓ RubyGems authentication present"

data/scripts/lib/version.sh

@@ -165,6 +165,45 @@ update_gemfile_lock() {
     fi
 }
 
+# Update version references in README.md (front matter, stats table, footer badge)
+update_readme() {
+    local new_version="$1"
+    local readme_file="README.md"
+
+    if [[ ! -f "$readme_file" ]]; then
+        debug "README.md not found, skipping"
+        return 0
+    fi
+
+    debug "Updating version references in $readme_file..."
+
+    if [[ "$DRY_RUN" == "true" ]]; then
+        info "[DRY RUN] Would update version references in $readme_file"
+        return 0
+    fi
+
+    local today
+    today=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
+
+    # Update all version patterns in a single sed pass
+    sed -i.tmp \
+        -e "s/^version: .*/version: $new_version/" \
+        -e "s/^lastmod: .*/lastmod: $today/" \
+        -e "s/| \*\*Current Version\*\* | [0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*/| **Current Version** | $new_version/" \
+        -e "s/\*\*v[0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*\*\*/**v${new_version}**/" \
+        "$readme_file"
+    rm -f "${readme_file}.tmp"
+
+    # Log which references were updated for visibility
+    if grep -q "^version: $new_version" "$readme_file"; then
+        debug "✓ Front matter version updated"
+    else
+        debug "⚠ Front matter version pattern not found"
+    fi
+
+    debug "✓ Updated $readme_file"
+}
+
 # Update version in all files
 update_version_files() {
     local new_version="$1"
@@ -176,6 +215,7 @@ update_version_files() {
     update_version_rb "$new_version"
     update_package_json "$new_version"
     update_gemfile_lock "$new_version"
+    update_readme "$new_version"
     
     success "Version files updated to $new_version"
 }
@@ -207,6 +247,7 @@ export -f calculate_new_version
 export -f update_version_rb
 export -f update_package_json
 export -f update_gemfile_lock
+export -f update_readme
 export -f update_version_files
 export -f version_less_than
 export -f get_version_from_tag

data/scripts/test/integration/mermaid

@@ -181,7 +181,7 @@ main() {
     # Mermaid include file tests
     log_info "Testing Mermaid include file..."
     
-    test_file_content "_includes/components/mermaid.html" "mermaid@10" "Mermaid v10 CDN link"
+    test_file_content "_includes/components/mermaid.html" "site.mermaid.src" "Mermaid script from _config (local vendor path)"
     test_file_content "_includes/components/mermaid.html" "mermaid.initialize" "Mermaid initialization script"
     test_file_content "_includes/components/mermaid.html" "forest" "Forest theme configured"
     test_file_content "_includes/components/mermaid.html" "FontAwesome" "FontAwesome support included"

data/scripts/vendor-install.sh

@@ -0,0 +1,196 @@
+#!/bin/bash
+
+# Vendor asset installer for zer0-mistakes Jekyll theme
+# Downloads third-party JS/CSS libraries defined in vendor-manifest.json
+#
+# Usage: ./scripts/vendor-install.sh [--force] [--verbose] [--dry-run]
+#
+# Prerequisites: curl, jq, shasum (or sha256sum)
+
+set -euo pipefail
+
+# Resolve paths
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+MANIFEST="$PROJECT_ROOT/vendor-manifest.json"
+
+# Source common library if available
+if [[ -f "$SCRIPT_DIR/lib/common.sh" ]]; then
+    source "$SCRIPT_DIR/lib/common.sh"
+else
+    # Minimal fallback logging (for CI environments without lib/common.sh)
+    RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'; CYAN='\033[0;36m'; NC='\033[0m'
+    log()     { echo -e "${GREEN}[LOG]${NC} $1"; }
+    info()    { echo -e "${BLUE}[INFO]${NC} $1"; }
+    step()    { echo -e "${CYAN}[STEP]${NC} $1"; }
+    success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+    warn()    { echo -e "${YELLOW}[WARNING]${NC} $1"; }
+    error()   { echo -e "${RED}[ERROR]${NC} $1" >&2; exit 1; }
+    DRY_RUN=${DRY_RUN:-false}
+    VERBOSE=${VERBOSE:-false}
+fi
+
+# Script-specific flags
+FORCE=${FORCE:-false}
+
+show_usage() {
+    cat << 'EOF'
+📦 Vendor Asset Installer for zer0-mistakes
+
+USAGE:
+    ./scripts/vendor-install.sh [OPTIONS]
+
+DESCRIPTION:
+    Downloads third-party libraries defined in vendor-manifest.json
+    into assets/vendor/. Verifies integrity via SHA-256 checksums.
+    Idempotent: skips files that already exist with matching checksums.
+
+OPTIONS:
+    --force       Re-download all files even if they exist
+    --dry-run     Show what would be downloaded without downloading
+    --verbose     Show detailed output
+    --help, -h    Show this help message
+
+EXAMPLES:
+    ./scripts/vendor-install.sh                 # Install vendor assets
+    ./scripts/vendor-install.sh --force         # Re-download everything
+    ./scripts/vendor-install.sh --dry-run       # Preview downloads
+EOF
+}
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --force)   FORCE=true; shift ;;
+        --dry-run) DRY_RUN=true; shift ;;
+        --verbose) VERBOSE=true; shift ;;
+        --help|-h) show_usage; exit 0 ;;
+        *) error "Unknown option: $1 (use --help for usage)" ;;
+    esac
+done
+
+# Detect checksum command
+if command -v sha256sum &>/dev/null; then
+    SHA_CMD="sha256sum"
+elif command -v shasum &>/dev/null; then
+    SHA_CMD="shasum -a 256"
+else
+    error "Neither sha256sum nor shasum found. Install coreutils."
+fi
+
+# Verify file checksum; returns 0 if match, 1 if mismatch
+verify_checksum() {
+    local file="$1"
+    local expected="$2"
+    [[ -z "$expected" ]] && return 0  # no checksum to verify
+    local actual
+    actual=$($SHA_CMD "$file" | cut -d' ' -f1)
+    [[ "$actual" == "$expected" ]]
+}
+
+# Main
+main() {
+    step "Vendor Asset Installer"
+
+    # Validate prerequisites
+    command -v curl &>/dev/null || error "curl is required but not found"
+    command -v jq &>/dev/null  || error "jq is required but not found"
+    [[ -f "$MANIFEST" ]]       || error "Manifest not found: $MANIFEST"
+
+    local lib_count
+    lib_count=$(jq '.libraries | length' "$MANIFEST")
+    info "Manifest: $lib_count libraries"
+
+    local total_files=0 downloaded=0 skipped=0 failed=0
+
+    for i in $(seq 0 $((lib_count - 1))); do
+        local lib_name lib_version file_count
+        lib_name=$(jq -r ".libraries[$i].name" "$MANIFEST")
+        lib_version=$(jq -r ".libraries[$i].version" "$MANIFEST")
+        file_count=$(jq ".libraries[$i].files | length" "$MANIFEST")
+
+        step "[$((i+1))/$lib_count] $lib_name v$lib_version ($file_count files)"
+
+        for j in $(seq 0 $((file_count - 1))); do
+            local url dest sha256
+            url=$(jq -r ".libraries[$i].files[$j].url" "$MANIFEST")
+            dest=$(jq -r ".libraries[$i].files[$j].dest" "$MANIFEST")
+            sha256=$(jq -r ".libraries[$i].files[$j].sha256 // empty" "$MANIFEST")
+
+            local dest_path="$PROJECT_ROOT/$dest"
+            total_files=$((total_files + 1))
+
+            # Check if file exists and checksum matches (skip unless --force)
+            if [[ "$FORCE" != "true" && -f "$dest_path" ]]; then
+                if [[ -n "$sha256" ]] && verify_checksum "$dest_path" "$sha256"; then
+                    [[ "$VERBOSE" == "true" ]] && info "  ✓ $dest (cached)"
+                    skipped=$((skipped + 1))
+                    continue
+                elif [[ -z "$sha256" ]]; then
+                    [[ "$VERBOSE" == "true" ]] && info "  ✓ $dest (exists, no checksum)"
+                    skipped=$((skipped + 1))
+                    continue
+                else
+                    warn "  ✗ $dest checksum mismatch, re-downloading"
+                fi
+            fi
+
+            if [[ "$DRY_RUN" == "true" ]]; then
+                info "  → would download: $dest"
+                downloaded=$((downloaded + 1))
+                continue
+            fi
+
+            # Create directory and download
+            mkdir -p "$(dirname "$dest_path")"
+            if curl -fsSL --retry 3 --retry-delay 2 -o "$dest_path" "$url"; then
+                # Verify checksum after download
+                if [[ -n "$sha256" ]]; then
+                    if verify_checksum "$dest_path" "$sha256"; then
+                        [[ "$VERBOSE" == "true" ]] && info "  ✓ $dest (downloaded, verified)"
+                    else
+                        warn "  ✗ $dest checksum mismatch after download!"
+                        rm -f "$dest_path"
+                        failed=$((failed + 1))
+                        continue
+                    fi
+                else
+                    [[ "$VERBOSE" == "true" ]] && info "  ✓ $dest (downloaded)"
+                fi
+                downloaded=$((downloaded + 1))
+            else
+                warn "  ✗ Failed to download: $url"
+                failed=$((failed + 1))
+            fi
+        done
+    done
+
+    echo ""
+    if [[ "$DRY_RUN" == "true" ]]; then
+        info "Dry run complete: $downloaded would download, $skipped cached, $failed errors"
+    else
+        success "Vendor install complete: $downloaded downloaded, $skipped cached, $failed errors (total: $total_files)"
+    fi
+
+    [[ $failed -gt 0 ]] && exit 1
+
+    # Mermaid: copy prebuilt dist from npm (avoids jsDelivr curl in the manifest).
+    if [[ "$DRY_RUN" != "true" ]]; then
+        copy_mermaid_from_npm() {
+            local src="$PROJECT_ROOT/node_modules/mermaid/dist/mermaid.min.js"
+            local dest="$PROJECT_ROOT/assets/vendor/mermaid/mermaid.min.js"
+            if [[ ! -f "$src" ]]; then
+                warn "Mermaid: node_modules/mermaid not found — run: npm install && npm run vendor:mermaid"
+                return 0
+            fi
+            mkdir -p "$(dirname "$dest")"
+            cp "$src" "$dest"
+            success "Mermaid: copied from npm package to assets/vendor/mermaid/mermaid.min.js"
+        }
+        copy_mermaid_from_npm
+    fi
+    return 0
+}
+
+main "$@"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-02-02 00:00:00.000000000 Z
+date: 2026-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -84,6 +84,7 @@ files:
 - _data/generate_statistics.rb
 - _data/generate_statistics.sh
 - _data/github-actions-example.yml
+- _data/glossary.yml
 - _data/navigation/README.md
 - _data/navigation/about.yml
 - _data/navigation/docs.yml
@@ -93,6 +94,7 @@ files:
 - _data/navigation/quickstart.yml
 - _data/posts_organization.yml
 - _data/prerequisites.yml
+- _data/prompts.yml
 - _data/statistics_config.yml
 - _data/ui-text.yml
 - _data/update_statistics.sh
@@ -102,8 +104,10 @@ files:
 - _includes/analytics/google-tag-manager-head.html
 - _includes/analytics/posthog.html
 - _includes/components/author-card.html
+- _includes/components/author-eeat.html
 - _includes/components/cookie-consent.html
 - _includes/components/dev-shortcuts.html
+- _includes/components/env-detect.html
 - _includes/components/env-switcher.html
 - _includes/components/halfmoon.html
 - _includes/components/info-section.html
@@ -121,6 +125,8 @@ files:
 - _includes/components/zer0-env-var.html
 - _includes/content/giscus.html
 - _includes/content/intro.html
+- _includes/content/jsonld-faq.html
+- _includes/content/jsonld-software.html
 - _includes/content/seo.html
 - _includes/content/sitemap.html
 - _includes/content/toc.html
@@ -166,22 +172,29 @@ files:
 - _layouts/tag.html
 - _plugins/preview_image_generator.rb
 - _plugins/theme_version.rb
-- _sass/core/_docs.scss
+- _sass/core/_docs-layout.scss
 - _sass/core/_nav-tree.scss
 - _sass/core/_navbar.scss
+- _sass/core/_offcanvas-panels.scss
 - _sass/core/_syntax.scss
 - _sass/core/_theme.scss
 - _sass/core/_variables.scss
 - _sass/core/code-copy.scss
 - _sass/custom.scss
 - _sass/notebooks.scss
+- _sass/theme/_color-modes.scss
+- _sass/theme/_css-variables.scss
+- _sass/theme/_wizard-mode.scss
 - assets/.DS_Store
 - assets/css/custom.css
 - assets/css/main.scss
 - assets/css/stats.css
+- assets/css/theme-npm-entry.scss
+- assets/css/vendor/.gitkeep
 - assets/data/notebooks/sales_data.csv
 - assets/data/notebooks/survey_responses.csv
 - assets/data/notebooks/weather_data.csv
+- assets/images/authors/bamr87.png
 - assets/images/favicon_gpt_computer_retro.png
 - assets/images/gravatar-small.png
 - assets/images/gravatar.png
@@ -234,6 +247,51 @@ files:
 - assets/js/side-bar-folders.js
 - assets/js/ui-enhancements.js
 - assets/particles.json
+- assets/vendor/bootstrap-icons/font/bootstrap-icons.css
+- assets/vendor/bootstrap-icons/font/fonts/bootstrap-icons.woff
+- assets/vendor/bootstrap-icons/font/fonts/bootstrap-icons.woff2
+- assets/vendor/bootstrap/css/bootstrap.min.css
+- assets/vendor/bootstrap/js/bootstrap.bundle.min.js
+- assets/vendor/font-awesome/css/all.min.css
+- assets/vendor/font-awesome/webfonts/fa-brands-400.ttf
+- assets/vendor/font-awesome/webfonts/fa-brands-400.woff2
+- assets/vendor/font-awesome/webfonts/fa-regular-400.ttf
+- assets/vendor/font-awesome/webfonts/fa-regular-400.woff2
+- assets/vendor/font-awesome/webfonts/fa-solid-900.ttf
+- assets/vendor/font-awesome/webfonts/fa-solid-900.woff2
+- assets/vendor/font-awesome/webfonts/fa-v4compatibility.ttf
+- assets/vendor/font-awesome/webfonts/fa-v4compatibility.woff2
+- assets/vendor/github-calendar/github-calendar-responsive.css
+- assets/vendor/github-calendar/github-calendar.min.js
+- assets/vendor/jquery/jquery-3.7.1.min.js
+- assets/vendor/mathjax/es5/adaptors/liteDOM.js
+- assets/vendor/mathjax/es5/core.js
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_AMS-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Calligraphic-Bold.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Calligraphic-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Fraktur-Bold.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Fraktur-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Main-Bold.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Main-Italic.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Main-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Math-BoldItalic.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Math-Italic.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Math-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_SansSerif-Bold.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_SansSerif-Italic.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_SansSerif-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Script-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Size1-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Size2-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Size3-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Size4-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Typewriter-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Vector-Bold.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Vector-Regular.woff
+- assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_Zero.woff
+- assets/vendor/mathjax/es5/startup.js
+- assets/vendor/mathjax/es5/tex-mml-chtml.js
+- assets/vendor/mermaid/mermaid.min.js
 - scripts/README.md
 - scripts/analyze-commits.sh
 - scripts/bin/build
@@ -281,6 +339,7 @@ files:
 - scripts/utils/analyze-commits
 - scripts/utils/fix-markdown
 - scripts/utils/setup
+- scripts/vendor-install.sh
 homepage: https://github.com/bamr87/zer0-mistakes
 licenses:
 - MIT