jekyll-theme-zer0 0.22.0 → 0.22.19

data/scripts/migrate.sh

@@ -0,0 +1,201 @@
+#!/bin/bash
+
+# =========================================================================
+# Zer0-Mistakes Theme — Migration Utility
+# =========================================================================
+# Install optional theme features (admin settings UI, etc.) into a
+# consumer Jekyll site that uses the zer0-mistakes theme.
+#
+# Usage:
+#   ./scripts/migrate.sh [options] [target_dir]
+#
+# Options:
+#   --admin          Install admin settings pages (default action)
+#   --force          Overwrite existing files
+#   --verify         Verify an existing installation
+#   --dry-run        Show what would be done without making changes
+#   --verbose        Enable verbose output
+#   --non-interactive  Skip confirmation prompts
+#   -h, --help       Show this help message
+#
+# Examples:
+#   # Install admin pages into current directory
+#   ./scripts/migrate.sh .
+#
+#   # Install into another site with force overwrite
+#   ./scripts/migrate.sh --force /path/to/my-site
+#
+#   # Verify existing installation
+#   ./scripts/migrate.sh --verify /path/to/my-site
+#
+#   # Preview changes without writing
+#   ./scripts/migrate.sh --dry-run /path/to/my-site
+# =========================================================================
+
+set -euo pipefail
+
+# -------------------------------------------------------------------------
+# Resolve script location and load libraries
+# -------------------------------------------------------------------------
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Source shared libraries
+# shellcheck source=lib/common.sh
+source "$SCRIPT_DIR/lib/common.sh"
+# shellcheck source=lib/template.sh
+source "$SCRIPT_DIR/lib/template.sh"
+# shellcheck source=lib/migrate.sh
+source "$SCRIPT_DIR/lib/migrate.sh"
+
+# -------------------------------------------------------------------------
+# Defaults
+# -------------------------------------------------------------------------
+ACTION="install"   # install | verify
+INSTALL_ADMIN=true
+FORCE=false
+TARGET_DIR=""
+
+# -------------------------------------------------------------------------
+# Usage
+# -------------------------------------------------------------------------
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") [options] [target_dir]
+
+Install optional zer0-mistakes theme features into a consumer Jekyll site.
+
+Options:
+  --admin              Install admin settings pages (default)
+  --force              Overwrite existing files
+  --verify             Verify an existing installation
+  --dry-run            Show what would be done without writing files
+  --verbose            Enable verbose/debug output
+  --non-interactive    Skip confirmation prompts
+  -h, --help           Show this help message
+
+Arguments:
+  target_dir           Path to the Jekyll site (default: current directory)
+
+Examples:
+  $(basename "$0") .                        # Install admin pages here
+  $(basename "$0") --force ../my-site       # Force overwrite in another site
+  $(basename "$0") --verify .               # Verify current installation
+  $(basename "$0") --dry-run ../my-site     # Preview changes
+EOF
+    exit 0
+}
+
+# -------------------------------------------------------------------------
+# Parse arguments
+# -------------------------------------------------------------------------
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --admin)          INSTALL_ADMIN=true; shift ;;
+        --force)          FORCE=true; shift ;;
+        --verify)         ACTION="verify"; shift ;;
+        --dry-run)        DRY_RUN=true; shift ;;
+        --verbose)        VERBOSE=true; shift ;;
+        --non-interactive) INTERACTIVE=false; shift ;;
+        -h|--help)        usage ;;
+        -*)               error "Unknown option: $1" ;;
+        *)                TARGET_DIR="$1"; shift ;;
+    esac
+done
+
+TARGET_DIR="${TARGET_DIR:-.}"
+TARGET_DIR="$(cd "$TARGET_DIR" 2>/dev/null && pwd)" || error "Directory not found: $TARGET_DIR"
+
+# -------------------------------------------------------------------------
+# Main
+# -------------------------------------------------------------------------
+
+main() {
+    echo ""
+    echo "╔══════════════════════════════════════════════════╗"
+    echo "║  Zer0-Mistakes Theme — Migration Utility        ║"
+    echo "╚══════════════════════════════════════════════════╝"
+    echo ""
+
+    info "Target site: $TARGET_DIR"
+    [[ "$DRY_RUN" == "true" ]] && info "Mode: DRY RUN (no files will be written)"
+    echo ""
+
+    # --- Step 1: Validate target ---
+    step "Detecting Jekyll site..."
+    if ! detect_jekyll_site "$TARGET_DIR"; then
+        error "Target does not appear to be a Jekyll site: $TARGET_DIR"
+    fi
+    success "Jekyll site detected"
+
+    # --- Step 2: Check theme connection ---
+    step "Checking theme connection..."
+    if validate_theme_connection "$TARGET_DIR"; then
+        success "Theme connection: $THEME_CONNECTION_TYPE"
+    else
+        warn "Could not confirm zer0-mistakes theme connection."
+        warn "Admin pages require the zer0-mistakes theme (layout: admin, includes, JS/CSS)."
+        if [[ "$INTERACTIVE" == "true" ]]; then
+            if ! confirm "Continue anyway?"; then
+                info "Aborted."
+                exit 0
+            fi
+        fi
+    fi
+
+    # --- Step 3: Check theme version ---
+    detect_version_gap "$TARGET_DIR" || true
+
+    # --- Step 4: Load template config ---
+    step "Loading template configuration..."
+    load_config || true
+    export CURRENT_DATE="${CURRENT_DATE:-$(date +%Y-%m-%d)}"
+
+    # --- Step 5: Execute action ---
+    case "$ACTION" in
+        install)
+            if [[ "$INSTALL_ADMIN" == "true" ]]; then
+                echo ""
+                if [[ "$FORCE" == "true" ]]; then
+                    info "Force mode enabled — existing files will be overwritten"
+                fi
+
+                if [[ "$INTERACTIVE" == "true" ]] && [[ "$DRY_RUN" != "true" ]]; then
+                    echo ""
+                    info "This will install admin settings pages to:"
+                    info "  $TARGET_DIR/$ADMIN_OUTPUT_DIR/"
+                    echo ""
+                    if ! confirm "Proceed with installation?"; then
+                        info "Aborted."
+                        exit 0
+                    fi
+                fi
+
+                install_admin_pages "$TARGET_DIR" "$FORCE"
+            fi
+            ;;
+        verify)
+            verify_admin_pages "$TARGET_DIR"
+            ;;
+    esac
+
+    # --- Step 6: Summary ---
+    echo ""
+    echo "────────────────────────────────────────────────────"
+    if [[ "$ACTION" == "install" ]]; then
+        success "Migration complete!"
+        echo ""
+        info "Next steps:"
+        info "  1. Start your Jekyll server and visit the admin pages"
+        info "  2. Theme Customizer:  /about/settings/theme/"
+        info "  3. Configuration:     /about/config/"
+        info "  4. Navigation Editor: /about/settings/navigation/"
+        info "  5. Collection Manager:/about/settings/collections/"
+        info "  6. Analytics:         /about/settings/analytics/"
+        info "  7. Environment:       /about/settings/environment/"
+    else
+        success "Verification complete."
+    fi
+    echo ""
+}
+
+main

data/scripts/platform/setup-linux.sh

@@ -0,0 +1,244 @@
+#!/bin/bash
+# =========================================================================
+# Zer0-Mistakes Platform Setup: Linux
+# =========================================================================
+# Detects distro and installs prerequisites for Linux.
+# Supports Debian/Ubuntu (apt), Fedora/RHEL (dnf), and Arch (pacman).
+#
+# Usage: source scripts/platform/setup-linux.sh
+#        setup_linux [--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
+
+# -------------------------------------------------------------------------
+# Detect Linux distribution
+# -------------------------------------------------------------------------
+detect_linux_distro() {
+    if [[ -f /etc/os-release ]]; then
+        # shellcheck source=/dev/null
+        source /etc/os-release
+        case "$ID" in
+            ubuntu|debian|pop|linuxmint|elementary)
+                echo "debian"
+                ;;
+            fedora|rhel|centos|rocky|alma)
+                echo "fedora"
+                ;;
+            arch|manjaro|endeavouros)
+                echo "arch"
+                ;;
+            opensuse*|sles)
+                echo "suse"
+                ;;
+            *)
+                echo "unknown"
+                ;;
+        esac
+    else
+        echo "unknown"
+    fi
+}
+
+get_distro_name() {
+    if [[ -f /etc/os-release ]]; then
+        # shellcheck source=/dev/null
+        source /etc/os-release
+        echo "${PRETTY_NAME:-Linux}"
+    else
+        echo "Linux"
+    fi
+}
+
+# -------------------------------------------------------------------------
+# Check prerequisites
+# -------------------------------------------------------------------------
+check_git_linux() {
+    command -v git &>/dev/null
+}
+
+check_docker_linux() {
+    command -v docker &>/dev/null && docker info &>/dev/null 2>&1
+}
+
+check_docker_installed_linux() {
+    command -v docker &>/dev/null
+}
+
+check_docker_compose_linux() {
+    # Docker Compose v2 (plugin) or v1 (standalone)
+    docker compose version &>/dev/null 2>&1 || command -v docker-compose &>/dev/null
+}
+
+check_ruby_linux() {
+    command -v ruby &>/dev/null && [[ "$(ruby -e 'puts RUBY_VERSION')" > "3.0" ]]
+}
+
+# -------------------------------------------------------------------------
+# Install prerequisites by distro
+# -------------------------------------------------------------------------
+install_git_linux() {
+    local distro
+    distro="$(detect_linux_distro)"
+    case "$distro" in
+        debian)  sudo apt-get update -qq && sudo apt-get install -y -qq git ;;
+        fedora)  sudo dnf install -y git ;;
+        arch)    sudo pacman -S --noconfirm git ;;
+        suse)    sudo zypper install -y git ;;
+        *)       log_error "Unsupported distro. Install git manually."; return 1 ;;
+    esac
+}
+
+install_docker_linux() {
+    local distro
+    distro="$(detect_linux_distro)"
+
+    log_info "Installing Docker Engine..."
+    case "$distro" in
+        debian)
+            # Determine the correct distro ID for the Docker repo URL
+            local docker_distro_id
+            # shellcheck source=/dev/null
+            docker_distro_id="$(. /etc/os-release 2>/dev/null && echo "${ID:-ubuntu}")"
+            # Docker only publishes repos for 'ubuntu' and 'debian'; other
+            # derivatives (pop, linuxmint, etc.) should use their base distro.
+            case "$docker_distro_id" in
+                debian) ;;             # already 'debian', use Docker's debian repo
+                *)      docker_distro_id="ubuntu" ;;  # fallback for Ubuntu derivatives
+            esac
+
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq ca-certificates curl gnupg
+            sudo install -m 0755 -d /etc/apt/keyrings
+            curl -fsSL "https://download.docker.com/linux/${docker_distro_id}/gpg" | \
+                sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg 2>/dev/null || true
+            sudo chmod a+r /etc/apt/keyrings/docker.gpg
+            # shellcheck source=/dev/null
+            echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/${docker_distro_id} $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
+                sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+            ;;
+        fedora)
+            sudo dnf -y install dnf-plugins-core
+            sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
+            sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+            ;;
+        arch)
+            sudo pacman -S --noconfirm docker docker-compose
+            ;;
+        *)
+            log_error "Auto-install not supported for this distro."
+            log_info "See https://docs.docker.com/engine/install/ for manual instructions."
+            return 1
+            ;;
+    esac
+
+    # Start Docker and enable on boot
+    sudo systemctl start docker 2>/dev/null || true
+    sudo systemctl enable docker 2>/dev/null || true
+
+    # Add current user to docker group (avoids sudo)
+    if ! groups | grep -q docker; then
+        sudo usermod -aG docker "$USER"
+        log_warning "Added $USER to docker group. Log out and back in for this to take effect."
+        log_info "Or run: newgrp docker"
+    fi
+}
+
+install_ruby_linux() {
+    local distro
+    distro="$(detect_linux_distro)"
+    case "$distro" in
+        debian)  sudo apt-get install -y -qq ruby-full build-essential ;;
+        fedora)  sudo dnf install -y ruby ruby-devel gcc make ;;
+        arch)    sudo pacman -S --noconfirm ruby base-devel ;;
+        *)       log_info "Install Ruby 3.0+ manually for your distribution." ;;
+    esac
+}
+
+# -------------------------------------------------------------------------
+# Main setup function
+# -------------------------------------------------------------------------
+setup_linux() {
+    local install_missing="${1:-false}"
+    local distro
+    distro="$(detect_linux_distro)"
+    local distro_name
+    distro_name="$(get_distro_name)"
+    local all_ok=true
+
+    log_info "Linux detected: ${distro_name} (family: ${distro})"
+    echo
+
+    # --- Git ---
+    if check_git_linux; then
+        log_success "Git: $(git --version)"
+    else
+        log_warning "Git: not installed"
+        if [[ "$install_missing" == "--install-missing" ]]; then
+            install_git_linux
+        else
+            log_info "  Install: sudo apt-get install git  (or equivalent)"
+            all_ok=false
+        fi
+    fi
+
+    # --- Docker ---
+    if check_docker_linux; then
+        log_success "Docker: $(docker --version)"
+    elif check_docker_installed_linux; then
+        log_warning "Docker: installed but daemon not running"
+        log_info "  Start: sudo systemctl start docker"
+        all_ok=false
+    else
+        log_warning "Docker: not installed"
+        if [[ "$install_missing" == "--install-missing" ]]; then
+            install_docker_linux
+        else
+            log_info "  Install: https://docs.docker.com/engine/install/"
+            all_ok=false
+        fi
+    fi
+
+    # --- Docker Compose ---
+    if check_docker_compose_linux; then
+        log_success "Docker Compose: available"
+    else
+        log_warning "Docker Compose: not found (installed with Docker Engine on most distros)"
+        all_ok=false
+    fi
+
+    # --- Ruby (optional) ---
+    if check_ruby_linux; then
+        log_success "Ruby: $(ruby --version)"
+    else
+        log_info "Ruby 3.0+: not found (only needed for native development, Docker works without it)"
+    fi
+
+    echo
+    if [[ "$all_ok" == true ]]; then
+        log_success "All Linux prerequisites satisfied."
+        return 0
+    else
+        log_warning "Some prerequisites are missing. Use --install-missing to auto-install."
+        return 1
+    fi
+}
+
+# ── Entrypoint (when executed directly, not sourced) ─────────────────────
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+    setup_linux "$@"
+fi

data/scripts/platform/setup-macos.sh

@@ -0,0 +1,187 @@
+#!/bin/bash
+# =========================================================================
+# Zer0-Mistakes Platform Setup: macOS
+# =========================================================================
+# Detects and installs prerequisites for macOS (Intel & Apple Silicon).
+# Called by install.sh during platform detection phase.
+#
+# Usage: source scripts/platform/setup-macos.sh
+#        setup_macos [--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
+
+# -------------------------------------------------------------------------
+# Detect macOS architecture
+# -------------------------------------------------------------------------
+detect_macos_arch() {
+    local arch
+    arch="$(uname -m)"
+    case "$arch" in
+        arm64)  echo "apple-silicon" ;;
+        x86_64) echo "intel" ;;
+        *)      echo "unknown" ;;
+    esac
+}
+
+# -------------------------------------------------------------------------
+# Check if Homebrew is installed
+# -------------------------------------------------------------------------
+check_homebrew() {
+    if command -v brew &>/dev/null; then
+        return 0
+    fi
+    return 1
+}
+
+install_homebrew() {
+    log_info "Installing Homebrew..."
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+    # Add Homebrew to PATH for Apple Silicon
+    if [[ "$(detect_macos_arch)" == "apple-silicon" ]]; then
+        eval "$(/opt/homebrew/bin/brew shellenv)"
+    fi
+}
+
+# -------------------------------------------------------------------------
+# Check individual prerequisites
+# -------------------------------------------------------------------------
+check_git_macos() {
+    command -v git &>/dev/null
+}
+
+check_docker_macos() {
+    command -v docker &>/dev/null && docker info &>/dev/null 2>&1
+}
+
+check_docker_installed_macos() {
+    command -v docker &>/dev/null
+}
+
+check_ruby_macos() {
+    command -v ruby &>/dev/null && [[ "$(ruby -e 'puts RUBY_VERSION')" > "3.0" ]]
+}
+
+# -------------------------------------------------------------------------
+# Install prerequisites
+# -------------------------------------------------------------------------
+install_git_macos() {
+    if check_homebrew; then
+        brew install git
+    else
+        log_info "Install Xcode Command Line Tools for git:"
+        xcode-select --install 2>/dev/null || true
+    fi
+}
+
+install_docker_macos() {
+    if check_homebrew; then
+        log_info "Installing Docker Desktop via Homebrew..."
+        brew install --cask docker
+        log_warning "Docker Desktop installed. Please open it from Applications to complete setup."
+        log_info "After Docker Desktop starts, re-run this installer."
+    else
+        log_info "Download Docker Desktop from: https://www.docker.com/products/docker-desktop"
+        log_info "Choose the $(detect_macos_arch) version for your Mac."
+    fi
+}
+
+install_ruby_macos() {
+    if check_homebrew; then
+        log_info "Installing Ruby via Homebrew..."
+        brew install ruby
+        log_info "Add Ruby to PATH: export PATH=\"/opt/homebrew/opt/ruby/bin:\$PATH\""
+    else
+        log_info "Install Homebrew first, then run: brew install ruby"
+    fi
+}
+
+# -------------------------------------------------------------------------
+# Main setup function
+# -------------------------------------------------------------------------
+setup_macos() {
+    local install_missing="${1:-false}"
+    local arch
+    arch="$(detect_macos_arch)"
+    local all_ok=true
+
+    log_info "macOS detected (${arch})"
+    echo
+
+    # --- Homebrew ---
+    if check_homebrew; then
+        log_success "Homebrew: $(brew --version | head -1)"
+    else
+        log_warning "Homebrew: not installed"
+        if [[ "$install_missing" == "--install-missing" ]]; then
+            install_homebrew
+        else
+            log_info "  Install: /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+            all_ok=false
+        fi
+    fi
+
+    # --- Git ---
+    if check_git_macos; then
+        log_success "Git: $(git --version)"
+    else
+        log_warning "Git: not installed"
+        if [[ "$install_missing" == "--install-missing" ]]; then
+            install_git_macos
+        else
+            log_info "  Install: brew install git"
+            all_ok=false
+        fi
+    fi
+
+    # --- Docker ---
+    if check_docker_macos; then
+        log_success "Docker: $(docker --version)"
+    elif check_docker_installed_macos; then
+        log_warning "Docker: installed but not running"
+        log_info "  Start Docker Desktop from Applications, then re-run."
+        all_ok=false
+    else
+        log_warning "Docker: not installed"
+        if [[ "$install_missing" == "--install-missing" ]]; then
+            install_docker_macos
+        else
+            log_info "  Install: brew install --cask docker"
+            all_ok=false
+        fi
+    fi
+
+    # --- Ruby (optional — only needed for non-Docker) ---
+    if check_ruby_macos; then
+        log_success "Ruby: $(ruby --version)"
+    else
+        log_info "Ruby 3.0+: not found (only needed for native development, Docker works without it)"
+    fi
+
+    echo
+    if [[ "$all_ok" == true ]]; then
+        log_success "All macOS prerequisites satisfied."
+        return 0
+    else
+        log_warning "Some prerequisites are missing. Use --install-missing to auto-install."
+        return 1
+    fi
+}
+
+# ── Entrypoint (when executed directly, not sourced) ─────────────────────
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+    setup_macos "$@"
+fi