jekyll-theme-zer0 0.20.3 → 0.21.2

data/scripts/docker-publish

@@ -0,0 +1,238 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# Docker Publish Script - Local Docker Image Publishing
+# ==============================================================================
+#
+# Publishes Docker images to Docker Hub from local environment.
+# Uses credentials from .env file or environment variables.
+#
+# Usage:
+#   ./scripts/docker-publish              # Build and push with auto-generated tag
+#   ./scripts/docker-publish --tag v1.0.0 # Build and push with specific tag
+#   ./scripts/docker-publish --latest     # Also update :latest tag
+#   ./scripts/docker-publish --dry-run    # Show what would happen
+#   ./scripts/docker-publish --build-only # Build but don't push
+#
+# ==============================================================================
+
+set -euo pipefail
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+log_warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1" >&2; }
+
+# Default values
+DRY_RUN=false
+BUILD_ONLY=false
+UPDATE_LATEST=false
+CUSTOM_TAG=""
+PLATFORM="linux/amd64"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --build-only)
+            BUILD_ONLY=true
+            shift
+            ;;
+        --latest)
+            UPDATE_LATEST=true
+            shift
+            ;;
+        --tag)
+            CUSTOM_TAG="$2"
+            shift 2
+            ;;
+        --platform)
+            PLATFORM="$2"
+            shift 2
+            ;;
+        --help|-h)
+            echo "Usage: $0 [OPTIONS]"
+            echo ""
+            echo "Options:"
+            echo "  --tag TAG       Use specific tag (default: auto-generated)"
+            echo "  --latest        Also update :latest tag"
+            echo "  --dry-run       Show what would happen without doing it"
+            echo "  --build-only    Build image but don't push"
+            echo "  --platform      Platform to build for (default: linux/amd64)"
+            echo "  --help          Show this help message"
+            echo ""
+            echo "Environment variables (from .env or shell):"
+            echo "  DOCKER_USERNAME  Docker Hub username"
+            echo "  DOCKER_TOKEN     Docker Hub access token"
+            echo "  DOCKER_IMAGE     Full image name (e.g., amrabdel/zer0-mistakes)"
+            exit 0
+            ;;
+        *)
+            log_error "Unknown option: $1"
+            exit 1
+            ;;
+    esac
+done
+
+# Load .env file if it exists
+if [[ -f "$PROJECT_ROOT/.env" ]]; then
+    log_info "Loading environment from .env file..."
+    set -a
+    source "$PROJECT_ROOT/.env"
+    set +a
+fi
+
+# Validate required variables
+if [[ -z "${DOCKER_USERNAME:-}" ]]; then
+    log_error "DOCKER_USERNAME is not set. Add it to .env or export it."
+    exit 1
+fi
+
+if [[ -z "${DOCKER_IMAGE:-}" ]]; then
+    log_error "DOCKER_IMAGE is not set. Add it to .env or export it."
+    exit 1
+fi
+
+if [[ "$BUILD_ONLY" == "false" && -z "${DOCKER_TOKEN:-}" ]]; then
+    log_error "DOCKER_TOKEN is not set. Add it to .env or export it."
+    log_info "Get your token at: https://hub.docker.com/settings/security"
+    exit 1
+fi
+
+# Generate tag if not provided
+if [[ -z "$CUSTOM_TAG" ]]; then
+    # Format: YYYYMMDD-HHMMSS-shortsha
+    DATE_TAG=$(date +%Y%m%d-%H%M%S)
+    SHORT_SHA=$(git rev-parse --short HEAD 2>/dev/null || echo "local")
+    IMAGE_TAG="${DATE_TAG}-${SHORT_SHA}"
+else
+    IMAGE_TAG="$CUSTOM_TAG"
+fi
+
+# Full image references
+FULL_IMAGE="${DOCKER_IMAGE}:${IMAGE_TAG}"
+LATEST_IMAGE="${DOCKER_IMAGE}:latest"
+
+log_info "=============================================="
+log_info "Docker Publish - Local"
+log_info "=============================================="
+log_info "Image:     ${DOCKER_IMAGE}"
+log_info "Tag:       ${IMAGE_TAG}"
+log_info "Platform:  ${PLATFORM}"
+log_info "Username:  ${DOCKER_USERNAME}"
+log_info "Dry run:   ${DRY_RUN}"
+log_info "Build only: ${BUILD_ONLY}"
+log_info "Update latest: ${UPDATE_LATEST}"
+log_info "=============================================="
+
+# Build the image
+build_image() {
+    log_info "Building Docker image..."
+    
+    local build_cmd="docker build \
+        --platform ${PLATFORM} \
+        --file docker/Dockerfile \
+        --target dev-test \
+        --tag ${FULL_IMAGE}"
+    
+    if [[ "$UPDATE_LATEST" == "true" ]]; then
+        build_cmd="$build_cmd --tag ${LATEST_IMAGE}"
+    fi
+    
+    build_cmd="$build_cmd ."
+    
+    if [[ "$DRY_RUN" == "true" ]]; then
+        log_info "[DRY RUN] Would execute: $build_cmd"
+    else
+        log_info "Executing: $build_cmd"
+        cd "$PROJECT_ROOT"
+        eval "$build_cmd"
+        log_success "Image built: ${FULL_IMAGE}"
+    fi
+}
+
+# Login to Docker Hub
+docker_login() {
+    log_info "Logging in to Docker Hub..."
+    
+    if [[ "$DRY_RUN" == "true" ]]; then
+        log_info "[DRY RUN] Would login to Docker Hub as ${DOCKER_USERNAME}"
+    else
+        echo "${DOCKER_TOKEN}" | docker login --username "${DOCKER_USERNAME}" --password-stdin
+        log_success "Logged in to Docker Hub"
+    fi
+}
+
+# Push the image
+push_image() {
+    log_info "Pushing image to Docker Hub..."
+    
+    if [[ "$DRY_RUN" == "true" ]]; then
+        log_info "[DRY RUN] Would push: ${FULL_IMAGE}"
+        if [[ "$UPDATE_LATEST" == "true" ]]; then
+            log_info "[DRY RUN] Would push: ${LATEST_IMAGE}"
+        fi
+    else
+        docker push "${FULL_IMAGE}"
+        log_success "Pushed: ${FULL_IMAGE}"
+        
+        if [[ "$UPDATE_LATEST" == "true" ]]; then
+            docker push "${LATEST_IMAGE}"
+            log_success "Pushed: ${LATEST_IMAGE}"
+        fi
+    fi
+}
+
+# Main execution
+main() {
+    cd "$PROJECT_ROOT"
+    
+    # Verify Docker is running
+    if ! docker info &>/dev/null; then
+        log_error "Docker is not running. Please start Docker Desktop."
+        exit 1
+    fi
+    
+    # Build the image
+    build_image
+    
+    # Stop here if build-only mode
+    if [[ "$BUILD_ONLY" == "true" ]]; then
+        log_success "Build complete (--build-only mode, not pushing)"
+        exit 0
+    fi
+    
+    # Login and push
+    docker_login
+    push_image
+    
+    # Summary
+    echo ""
+    log_success "=============================================="
+    log_success "Docker Publish Complete!"
+    log_success "=============================================="
+    log_info "Image: ${FULL_IMAGE}"
+    log_info "URL:   https://hub.docker.com/r/${DOCKER_IMAGE}/tags"
+    if [[ "$UPDATE_LATEST" == "true" ]]; then
+        log_info "Latest: ${LATEST_IMAGE}"
+    fi
+    echo ""
+    log_info "To pull this image:"
+    log_info "  docker pull ${FULL_IMAGE}"
+}
+
+main

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/git.sh

@@ -74,15 +74,17 @@ create_commit() {
         return 0
     fi
     
-    # Add files
+    # Add files (including Gemfile.lock which is updated when version changes)
     git add lib/jekyll-theme-zer0/version.rb CHANGELOG.md
     [[ -f "package.json" ]] && git add package.json
+    [[ -f "Gemfile.lock" ]] && git add Gemfile.lock
     
     # Create commit
     git commit -m "chore: release version $version
 
 - Version bump to $version
 - Updated changelog with commit history
+- Regenerated Gemfile.lock for version sync
 - Automated release via release script" || error "Failed to create commit"
     
     success "Created commit for version $version"

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

@@ -133,6 +133,38 @@ update_package_json() {
     debug "✓ Updated $PACKAGE_JSON"
 }
 
+# Update Gemfile.lock to reflect new gem version
+# This is CRITICAL - when version.rb changes, Gemfile.lock must be regenerated
+# because the gem is listed as a PATH dependency in Gemfile
+update_gemfile_lock() {
+    local new_version="$1"
+    
+    debug "Regenerating Gemfile.lock for version $new_version..."
+    
+    if [[ "$DRY_RUN" == "true" ]]; then
+        info "[DRY RUN] Would regenerate Gemfile.lock"
+        return 0
+    fi
+    
+    # Unfreeze bundler to allow lockfile update
+    bundle config set --local frozen false 2>/dev/null || true
+    bundle config unset deployment 2>/dev/null || true
+    
+    # Regenerate lockfile
+    if ! bundle install --quiet; then
+        warn "bundle install returned non-zero, but may have succeeded"
+    fi
+    
+    # Verify the lockfile was updated
+    if grep -q "jekyll-theme-zer0 ($new_version)" Gemfile.lock 2>/dev/null; then
+        debug "✓ Gemfile.lock updated to version $new_version"
+    else
+        warn "Gemfile.lock may not have been updated correctly"
+        info "Current Gemfile.lock gem version:"
+        grep "jekyll-theme-zer0" Gemfile.lock | head -3 || true
+    fi
+}
+
 # Update version in all files
 update_version_files() {
     local new_version="$1"
@@ -143,6 +175,7 @@ update_version_files() {
     
     update_version_rb "$new_version"
     update_package_json "$new_version"
+    update_gemfile_lock "$new_version"
     
     success "Version files updated to $new_version"
 }
@@ -173,6 +206,7 @@ export -f validate_version_format
 export -f calculate_new_version
 export -f update_version_rb
 export -f update_package_json
+export -f update_gemfile_lock
 export -f update_version_files
 export -f version_less_than
 export -f get_version_from_tag

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 0.20.3
+  version: 0.21.2
 platform: ruby
 authors:
 - Amr Abdel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -104,6 +104,7 @@ files:
 - _includes/components/author-card.html
 - _includes/components/cookie-consent.html
 - _includes/components/dev-shortcuts.html
+- _includes/components/env-switcher.html
 - _includes/components/halfmoon.html
 - _includes/components/info-section.html
 - _includes/components/js-cdn.html
@@ -167,6 +168,7 @@ files:
 - _plugins/theme_version.rb
 - _sass/core/_docs.scss
 - _sass/core/_nav-tree.scss
+- _sass/core/_navbar.scss
 - _sass/core/_syntax.scss
 - _sass/core/_theme.scss
 - _sass/core/_variables.scss
@@ -225,6 +227,7 @@ files:
 - assets/js/modules/navigation/smooth-scroll.js
 - assets/js/myScript.js
 - assets/js/nanobar.min.js
+- assets/js/navigation.js
 - assets/js/particles-source.js
 - assets/js/particles.js
 - assets/js/search-modal.js
@@ -238,6 +241,7 @@ files:
 - scripts/bin/test
 - scripts/build
 - scripts/convert-notebooks.sh
+- scripts/docker-publish
 - scripts/example-usage.sh
 - scripts/features/generate-preview-images
 - scripts/features/install-preview-generator