jekyll-theme-zer0 0.22.5 → 0.22.20

data/scripts/platform/setup-wsl.sh

@@ -0,0 +1,196 @@
+#!/bin/bash
+# =========================================================================
+# Zer0-Mistakes Platform Setup: Windows (WSL)
+# =========================================================================
+# Detects WSL version, validates Docker Desktop integration, and provides
+# guidance for Windows users who are NOT yet in WSL.
+#
+# Usage: source scripts/platform/setup-wsl.sh
+#        setup_wsl [--install-missing]
+# =========================================================================
+
+# Only enable strict mode when executed directly (not sourced), so we don't
+# mutate the caller's shell options.
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+    set -euo pipefail
+fi
+
+# ── Fallback logging helpers (used when not sourced from install.sh) ─────
+if ! declare -F log_info >/dev/null 2>&1; then
+    log_info()    { echo "[INFO]    $*"; }
+    log_success() { echo "[SUCCESS] $*"; }
+    log_warning() { echo "[WARNING] $*"; }
+    log_error()   { echo "[ERROR]   $*" >&2; }
+fi
+
+# -------------------------------------------------------------------------
+# WSL detection helpers
+# -------------------------------------------------------------------------
+is_wsl() {
+    [[ -f /proc/version ]] && grep -qi 'microsoft\|wsl' /proc/version 2>/dev/null
+}
+
+detect_wsl_version() {
+    if [[ -f /proc/version ]]; then
+        if grep -qi 'WSL2' /proc/version 2>/dev/null; then
+            echo "2"
+        elif grep -qi 'microsoft\|wsl' /proc/version 2>/dev/null; then
+            echo "1"
+        else
+            echo "0"
+        fi
+    else
+        echo "0"
+    fi
+}
+
+detect_wsl_distro() {
+    if [[ -f /etc/os-release ]]; then
+        # shellcheck source=/dev/null
+        source /etc/os-release
+        echo "${PRETTY_NAME:-WSL Linux}"
+    else
+        echo "WSL Linux"
+    fi
+}
+
+# -------------------------------------------------------------------------
+# Check Docker Desktop integration
+# -------------------------------------------------------------------------
+check_docker_wsl() {
+    # In WSL, Docker Desktop provides a docker CLI via integration
+    if command -v docker &>/dev/null && docker info &>/dev/null 2>&1; then
+        return 0
+    fi
+    return 1
+}
+
+check_docker_desktop_integration() {
+    # Docker Desktop creates this socket when WSL integration is enabled
+    [[ -S /var/run/docker.sock ]] || [[ -S "$HOME/.docker/run/docker.sock" ]]
+}
+
+# -------------------------------------------------------------------------
+# Provide Windows setup guidance (for users not yet in WSL)
+# -------------------------------------------------------------------------
+print_windows_native_guide() {
+    echo
+    log_error "This script must be run inside WSL (Windows Subsystem for Linux)."
+    echo
+    echo "======================================================================"
+    echo "  WINDOWS SETUP GUIDE — 3 Steps to Get Running"
+    echo "======================================================================"
+    echo
+    echo "  Step 1: Install WSL 2 (open PowerShell as Administrator):"
+    echo
+    echo "      wsl --install"
+    echo
+    echo "  Step 2: Install Docker Desktop for Windows:"
+    echo
+    echo "      https://www.docker.com/products/docker-desktop"
+    echo
+    echo "      In Docker Desktop Settings → Resources → WSL Integration:"
+    echo "      ✅  Enable integration with your WSL 2 distro"
+    echo
+    echo "  Step 3: Open your WSL terminal and run the installer:"
+    echo
+    echo "      mkdir my-site && cd my-site"
+    echo "      curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash"
+    echo
+    echo "======================================================================"
+    echo
+    echo "  Detailed guide: https://learn.microsoft.com/en-us/windows/wsl/install"
+    echo
+}
+
+# -------------------------------------------------------------------------
+# Main setup function
+# -------------------------------------------------------------------------
+setup_wsl() {
+    local install_missing="${1:-false}"
+    local wsl_ver
+    wsl_ver="$(detect_wsl_version)"
+    local wsl_distro
+    wsl_distro="$(detect_wsl_distro)"
+    local all_ok=true
+
+    log_info "WSL detected: ${wsl_distro} (WSL ${wsl_ver})"
+    echo
+
+    # --- WSL version check ---
+    if [[ "$wsl_ver" == "2" ]]; then
+        log_success "WSL 2: required for Docker Desktop integration"
+    elif [[ "$wsl_ver" == "1" ]]; then
+        log_error "WSL 1 detected — Docker Desktop requires WSL 2."
+        echo
+        log_info "Upgrade to WSL 2 (run from Windows PowerShell / Command Prompt):"
+        echo "  1. wsl.exe -l -v                    # list distros and their WSL versions"
+        echo "  2. wsl.exe --set-version <DistroName> 2   # upgrade a specific distro"
+        echo "  3. wsl.exe --set-default-version 2  # make WSL 2 the default for new distros"
+        echo
+        return 1
+    fi
+
+    # --- Git ---
+    if command -v git &>/dev/null; then
+        log_success "Git: $(git --version)"
+    else
+        log_warning "Git: not installed"
+        if [[ "$install_missing" == "--install-missing" ]]; then
+            sudo apt-get update -qq && sudo apt-get install -y -qq git
+        else
+            log_info "  Install: sudo apt-get install git"
+            all_ok=false
+        fi
+    fi
+
+    # --- Docker (via Docker Desktop integration) ---
+    if check_docker_wsl; then
+        log_success "Docker: $(docker --version) (via Docker Desktop)"
+    elif check_docker_desktop_integration; then
+        log_warning "Docker socket found but daemon not responding."
+        log_info "  Make sure Docker Desktop is running on Windows."
+        all_ok=false
+    else
+        log_warning "Docker: not available in this WSL session"
+        echo
+        log_info "Docker Desktop WSL 2 integration setup:"
+        echo "  1. Install Docker Desktop for Windows"
+        echo "     https://www.docker.com/products/docker-desktop"
+        echo "  2. Open Docker Desktop → Settings → Resources → WSL Integration"
+        echo "  3. Enable integration with your distro (${wsl_distro})"
+        echo "  4. Restart this WSL terminal"
+        echo
+        all_ok=false
+    fi
+
+    # --- Line ending configuration ---
+    if command -v git &>/dev/null; then
+        local autocrlf
+        autocrlf="$(git config --global core.autocrlf 2>/dev/null || echo "")"
+        if [[ "$autocrlf" == "input" ]]; then
+            log_success "Git line endings: core.autocrlf=input (correct for WSL)"
+        else
+            log_warning "Git line endings: core.autocrlf=${autocrlf:-unset}"
+            log_info "  Recommended: git config --global core.autocrlf input"
+            if [[ "$install_missing" == "--install-missing" ]]; then
+                git config --global core.autocrlf input
+                log_success "Set core.autocrlf=input"
+            fi
+        fi
+    fi
+
+    echo
+    if [[ "$all_ok" == true ]]; then
+        log_success "All WSL prerequisites satisfied."
+        return 0
+    else
+        log_warning "Some prerequisites are missing. See guidance above."
+        return 1
+    fi
+}
+
+# ── Entrypoint (when executed directly, not sourced) ─────────────────────
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+    setup_wsl "$@"
+fi

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 0.22.5
+  version: 0.22.20
 platform: ruby
 authors:
 - Amr Abdel
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-04-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -87,6 +87,7 @@ files:
 - _data/glossary.yml
 - _data/navigation/README.md
 - _data/navigation/about.yml
+- _data/navigation/admin.yml
 - _data/navigation/docs.yml
 - _data/navigation/home.yml
 - _data/navigation/main.yml
@@ -96,6 +97,7 @@ files:
 - _data/prerequisites.yml
 - _data/prompts.yml
 - _data/statistics_config.yml
+- _data/theme_backgrounds.yml
 - _data/ui-text.yml
 - _data/update_statistics.sh
 - _includes/README.md
@@ -103,16 +105,28 @@ files:
 - _includes/analytics/google-tag-manager-body.html
 - _includes/analytics/google-tag-manager-head.html
 - _includes/analytics/posthog.html
+- _includes/components/admin-tabs.html
+- _includes/components/analytics-dashboard.html
 - _includes/components/author-card.html
 - _includes/components/author-eeat.html
+- _includes/components/background-customizer.html
+- _includes/components/background-settings.html
+- _includes/components/collection-manager.html
+- _includes/components/component-showcase.html
+- _includes/components/config-editor.html
+- _includes/components/config-viewer.html
 - _includes/components/cookie-consent.html
 - _includes/components/dev-shortcuts.html
+- _includes/components/env-dashboard.html
 - _includes/components/env-detect.html
 - _includes/components/env-switcher.html
+- _includes/components/feature-card.html
 - _includes/components/halfmoon.html
 - _includes/components/info-section.html
 - _includes/components/js-cdn.html
 - _includes/components/mermaid.html
+- _includes/components/nanobar.html
+- _includes/components/nav-editor.html
 - _includes/components/post-card.html
 - _includes/components/post-type-badge.html
 - _includes/components/powered-by.html
@@ -120,7 +134,11 @@ files:
 - _includes/components/quick-index.html
 - _includes/components/search-modal.html
 - _includes/components/searchbar.html
+- _includes/components/setup-banner.html
+- _includes/components/setup-check.html
+- _includes/components/svg-background.html
 - _includes/components/svg.html
+- _includes/components/theme-customizer.html
 - _includes/components/theme-info.html
 - _includes/components/zer0-env-var.html
 - _includes/content/giscus.html
@@ -137,6 +155,7 @@ files:
 - _includes/docs/bootstrap-docs.html
 - _includes/landing/landing-install-cards.html
 - _includes/landing/landing-quick-links.html
+- _includes/navigation/admin-nav.html
 - _includes/navigation/breadcrumbs.html
 - _includes/navigation/nav-tree.html
 - _includes/navigation/nav_list.html
@@ -147,6 +166,7 @@ files:
 - _includes/navigation/sidebar-left.html
 - _includes/navigation/sidebar-right.html
 - _includes/search-data.json
+- _includes/setup/wizard.html
 - _includes/stats/README.md
 - _includes/stats/stats-categories.html
 - _includes/stats/stats-header.html
@@ -155,6 +175,7 @@ files:
 - _includes/stats/stats-overview.html
 - _includes/stats/stats-tags.html
 - _layouts/README.md
+- _layouts/admin.html
 - _layouts/article.html
 - _layouts/collection.html
 - _layouts/default.html
@@ -167,6 +188,7 @@ files:
 - _layouts/root.html
 - _layouts/search.html
 - _layouts/section.html
+- _layouts/setup.html
 - _layouts/sitemap-collection.html
 - _layouts/stats.html
 - _layouts/tag.html
@@ -182,10 +204,39 @@ files:
 - _sass/core/code-copy.scss
 - _sass/custom.scss
 - _sass/notebooks.scss
+- _sass/theme/_background-mixins.scss
+- _sass/theme/_backgrounds.scss
 - _sass/theme/_color-modes.scss
 - _sass/theme/_css-variables.scss
 - _sass/theme/_wizard-mode.scss
 - assets/.DS_Store
+- assets/backgrounds/gradients/air.svg
+- assets/backgrounds/gradients/aqua.svg
+- assets/backgrounds/gradients/contrast.svg
+- assets/backgrounds/gradients/dark.svg
+- assets/backgrounds/gradients/dirt.svg
+- assets/backgrounds/gradients/mint.svg
+- assets/backgrounds/gradients/neon.svg
+- assets/backgrounds/gradients/plum.svg
+- assets/backgrounds/gradients/sunrise.svg
+- assets/backgrounds/noise/air.svg
+- assets/backgrounds/noise/aqua.svg
+- assets/backgrounds/noise/contrast.svg
+- assets/backgrounds/noise/dark.svg
+- assets/backgrounds/noise/dirt.svg
+- assets/backgrounds/noise/mint.svg
+- assets/backgrounds/noise/neon.svg
+- assets/backgrounds/noise/plum.svg
+- assets/backgrounds/noise/sunrise.svg
+- assets/backgrounds/patterns/air.svg
+- assets/backgrounds/patterns/aqua.svg
+- assets/backgrounds/patterns/contrast.svg
+- assets/backgrounds/patterns/dark.svg
+- assets/backgrounds/patterns/dirt.svg
+- assets/backgrounds/patterns/mint.svg
+- assets/backgrounds/patterns/neon.svg
+- assets/backgrounds/patterns/plum.svg
+- assets/backgrounds/patterns/sunrise.svg
 - assets/css/custom.css
 - assets/css/main.scss
 - assets/css/stats.css
@@ -225,9 +276,11 @@ files:
 - assets/images/zer0-mistakes-wizard.png
 - assets/js/auto-hide-nav.js
 - assets/js/back-to-top.js
+- assets/js/background-customizer.js
 - assets/js/cheetsheet.js
 - assets/js/code-copy.js
 - assets/js/color-modes.js
+- assets/js/config-utility.js
 - assets/js/docs.min.js
 - assets/js/halfmoon.js
 - assets/js/modules/navigation/config.js
@@ -239,12 +292,18 @@ files:
 - assets/js/modules/navigation/sidebar-state.js
 - assets/js/modules/navigation/smooth-scroll.js
 - assets/js/myScript.js
+- assets/js/nanobar-init.js
 - assets/js/nanobar.min.js
+- assets/js/nav-editor.js
 - assets/js/navigation.js
+- assets/js/palette-generator.js
 - assets/js/particles-source.js
 - assets/js/particles.js
 - assets/js/search-modal.js
+- assets/js/setup-wizard.js
 - assets/js/side-bar-folders.js
+- assets/js/skin-editor.js
+- assets/js/theme-customizer.js
 - assets/js/ui-enhancements.js
 - assets/particles.json
 - assets/vendor/bootstrap-icons/font/bootstrap-icons.css
@@ -307,18 +366,26 @@ files:
 - scripts/fix-markdown-format.sh
 - scripts/fork-cleanup.sh
 - scripts/generate-preview-images.sh
+- scripts/github-setup.sh
 - scripts/init_setup.sh
 - scripts/install-preview-generator.sh
 - scripts/lib/README.md
 - scripts/lib/changelog.sh
 - scripts/lib/common.sh
+- scripts/lib/frontmatter.sh
 - scripts/lib/gem.sh
 - scripts/lib/git.sh
+- scripts/lib/migrate.sh
 - scripts/lib/preview_generator.py
 - scripts/lib/template.sh
 - scripts/lib/validation.sh
 - scripts/lib/version.sh
+- scripts/lint-pages
 - scripts/migrate-nav-modes.sh
+- scripts/migrate.sh
+- scripts/platform/setup-linux.sh
+- scripts/platform/setup-macos.sh
+- scripts/platform/setup-wsl.sh
 - scripts/post-template-setup.sh
 - scripts/release
 - scripts/setup.sh
@@ -350,7 +417,7 @@ metadata:
   changelog_uri: https://github.com/bamr87/zer0-mistakes/blob/main/CHANGELOG.md
   documentation_uri: https://github.com/bamr87/zer0-mistakes#readme
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -365,8 +432,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Jekyll theme based on bootstrap and compatible with github pages
 test_files: []