jekyll-theme-zer0 0.15.0 → 0.16.0

data/scripts/README.md

@@ -91,7 +91,14 @@ Options:
   --dry-run           Preview without changes
   --collection TYPE   Generate for specific collection (posts, docs, etc.)
   -f, --file PATH     Process specific file
-  --provider PROVIDER Use specific AI provider (openai)
+  --provider PROVIDER Use specific AI provider (openai, stability, xai)
+  --assets-prefix     Custom assets path prefix (default: /assets)
+  --no-auto-prefix    Disable automatic path prefixing
+
+AI Providers:
+  openai    - OpenAI DALL-E (requires OPENAI_API_KEY)
+  stability - Stability AI (requires STABILITY_API_KEY)
+  xai       - xAI Grok image generation (requires XAI_API_KEY)
 ```
 
 #### `install-preview-generator`
@@ -209,11 +216,14 @@ The project includes GitHub Actions workflows for automation:
 ## Requirements
 
 ### System Dependencies
+- **Bash**: >= 3.2 (macOS default supported - no Homebrew Bash required!)
 - **Ruby**: >= 2.7.0
 - **Bundler**: For dependency management
 - **jq**: For JSON processing
 - **Git**: For version control
 
+**Note on Bash Compatibility**: All scripts are compatible with Bash 3.2+ (the default version on macOS). You do NOT need to install Homebrew Bash. The release automation, changelog generation, and all CI/CD workflows work seamlessly with the system-provided Bash on macOS and standard Bash installations on Linux.
+
 ### RubyGems Publishing Setup
 To publish gems, you need:
 

data/scripts/lib/changelog.sh

@@ -2,14 +2,7 @@
 
 # Changelog generation library for zer0-mistakes release scripts
 # Provides automatic changelog generation from git commit history
-
-# Check Bash version (need 4+ for associative arrays)
-if [[ "${BASH_VERSINFO[0]}" -lt 4 ]]; then
-    echo "[ERROR] This script requires Bash 4.0 or higher (current: ${BASH_VERSION})" >&2
-    echo "[INFO] On macOS, install via: brew install bash" >&2
-    echo "[INFO] Then update scripts to use: #!/usr/local/bin/bash" >&2
-    exit 1
-fi
+# Compatible with Bash 3.2+ (macOS default) and Bash 4+
 
 # Source common utilities
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -119,18 +112,19 @@ generate_changelog() {
         return 0
     fi
     
-    # Parse and categorize commits
-    declare -A categories
-    categories=(
-        ["breaking"]=""
-        ["added"]=""
-        ["changed"]=""
-        ["deprecated"]=""
-        ["removed"]=""
-        ["fixed"]=""
-        ["security"]=""
-        ["other"]=""
-    )
+    # Parse and categorize commits using parallel indexed arrays (Bash 3.2 compatible)
+    # Category names in order
+    local category_names=("breaking" "added" "changed" "deprecated" "removed" "fixed" "security" "other")
+    
+    # Initialize category content arrays
+    local cat_breaking=""
+    local cat_added=""
+    local cat_changed=""
+    local cat_deprecated=""
+    local cat_removed=""
+    local cat_fixed=""
+    local cat_security=""
+    local cat_other=""
     
     local commit_count=0
     while IFS='|' read -r hash subject author date; do
@@ -176,10 +170,41 @@ generate_changelog() {
         local clean_msg
         clean_msg=$(clean_commit_message "$subject")
         
-        if [[ -n "${categories[$category]}" ]]; then
-            categories[$category]+=$'\n'
-        fi
-        categories[$category]+="- $clean_msg"
+        # Append to appropriate category variable
+        case "$category" in
+            "breaking")
+                [[ -n "$cat_breaking" ]] && cat_breaking+=$'\n'
+                cat_breaking+="- $clean_msg"
+                ;;
+            "added")
+                [[ -n "$cat_added" ]] && cat_added+=$'\n'
+                cat_added+="- $clean_msg"
+                ;;
+            "changed")
+                [[ -n "$cat_changed" ]] && cat_changed+=$'\n'
+                cat_changed+="- $clean_msg"
+                ;;
+            "deprecated")
+                [[ -n "$cat_deprecated" ]] && cat_deprecated+=$'\n'
+                cat_deprecated+="- $clean_msg"
+                ;;
+            "removed")
+                [[ -n "$cat_removed" ]] && cat_removed+=$'\n'
+                cat_removed+="- $clean_msg"
+                ;;
+            "fixed")
+                [[ -n "$cat_fixed" ]] && cat_fixed+=$'\n'
+                cat_fixed+="- $clean_msg"
+                ;;
+            "security")
+                [[ -n "$cat_security" ]] && cat_security+=$'\n'
+                cat_security+="- $clean_msg"
+                ;;
+            "other")
+                [[ -n "$cat_other" ]] && cat_other+=$'\n'
+                cat_other+="- $clean_msg"
+                ;;
+        esac
         
     done <<< "$commits_raw"
     
@@ -192,39 +217,46 @@ generate_changelog() {
     
     changelog_entry+="## [$new_version] - $date"$'\n\n'
     
-    # Add sections in order
-    for category in "breaking" "added" "changed" "deprecated" "removed" "fixed" "security" "other"; do
-        if [[ -n "${categories[$category]}" ]]; then
-            case "$category" in
-                "breaking")
-                    changelog_entry+="### ⚠️  BREAKING CHANGES"$'\n'
-                    ;;
-                "added")
-                    changelog_entry+="### Added"$'\n'
-                    ;;
-                "changed")
-                    changelog_entry+="### Changed"$'\n'
-                    ;;
-                "deprecated")
-                    changelog_entry+="### Deprecated"$'\n'
-                    ;;
-                "removed")
-                    changelog_entry+="### Removed"$'\n'
-                    ;;
-                "fixed")
-                    changelog_entry+="### Fixed"$'\n'
-                    ;;
-                "security")
-                    changelog_entry+="### Security"$'\n'
-                    ;;
-                "other")
-                    changelog_entry+="### Other"$'\n'
-                    ;;
-            esac
-            
-            changelog_entry+="${categories[$category]}"$'\n\n'
-        fi
-    done
+    # Add sections in order (using individual variables instead of associative array)
+    if [[ -n "$cat_breaking" ]]; then
+        changelog_entry+="### ⚠️  BREAKING CHANGES"$'\n'
+        changelog_entry+="$cat_breaking"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_added" ]]; then
+        changelog_entry+="### Added"$'\n'
+        changelog_entry+="$cat_added"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_changed" ]]; then
+        changelog_entry+="### Changed"$'\n'
+        changelog_entry+="$cat_changed"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_deprecated" ]]; then
+        changelog_entry+="### Deprecated"$'\n'
+        changelog_entry+="$cat_deprecated"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_removed" ]]; then
+        changelog_entry+="### Removed"$'\n'
+        changelog_entry+="$cat_removed"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_fixed" ]]; then
+        changelog_entry+="### Fixed"$'\n'
+        changelog_entry+="$cat_fixed"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_security" ]]; then
+        changelog_entry+="### Security"$'\n'
+        changelog_entry+="$cat_security"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_other" ]]; then
+        changelog_entry+="### Other"$'\n'
+        changelog_entry+="$cat_other"$'\n\n'
+    fi
     
     # Preview changelog
     info "Changelog preview:"

data/scripts/lib/preview_generator.py

@@ -101,6 +101,8 @@ class PreviewGenerator:
         output_dir: str = "assets/images/previews",
         image_style: str = "digital art, professional blog illustration",
         image_size: str = "1024x1024",
+        assets_prefix: str = "/assets",
+        auto_prefix: bool = True,
         dry_run: bool = False,
         verbose: bool = False,
         force: bool = False,
@@ -110,6 +112,8 @@ class PreviewGenerator:
         self.output_dir = project_root / output_dir
         self.image_style = image_style
         self.image_size = image_size
+        self.assets_prefix = assets_prefix
+        self.auto_prefix = auto_prefix
         self.dry_run = dry_run
         self.verbose = verbose
         self.force = force
@@ -129,6 +133,27 @@ class PreviewGenerator:
         if self.verbose:
             log(msg, "debug")
     
+    def normalize_preview_path(self, preview_path: Optional[str]) -> Optional[str]:
+        """Normalize a preview path by adding assets_prefix if needed.
+        
+        This allows users to omit the /assets/ prefix in frontmatter:
+        - /images/previews/my-image.png -> /assets/images/previews/my-image.png
+        - /assets/images/previews/my-image.png -> unchanged
+        - https://example.com/image.png -> unchanged (external URL)
+        """
+        if not preview_path:
+            return preview_path
+        
+        # External URLs pass through unchanged
+        if preview_path.startswith('http://') or preview_path.startswith('https://'):
+            return preview_path
+        
+        # If auto_prefix is enabled and path doesn't contain assets_prefix
+        if self.auto_prefix and self.assets_prefix not in preview_path:
+            return f"{self.assets_prefix}{preview_path}"
+        
+        return preview_path
+    
     def parse_front_matter(self, file_path: Path) -> Optional[ContentFile]:
         """Parse front matter and content from a markdown file."""
         try:
@@ -178,19 +203,19 @@ class PreviewGenerator:
         if not preview_path:
             return False
         
+        # Normalize the path first (adds assets_prefix if needed)
+        normalized_path = self.normalize_preview_path(preview_path)
+        if not normalized_path:
+            return False
+        
         # Handle absolute and relative paths
-        clean_path = preview_path.lstrip('/')
+        clean_path = normalized_path.lstrip('/')
         
         # Check direct path
         full_path = self.project_root / clean_path
         if full_path.exists():
             return True
         
-        # Check in assets directory
-        assets_path = self.project_root / 'assets' / clean_path
-        if assets_path.exists():
-            return True
-        
         return False
     
     def generate_prompt(self, content: ContentFile) -> str:
@@ -395,12 +420,131 @@ class PreviewGenerator:
                 prompt_used=prompt,
             )
     
+    def generate_image_xai(self, prompt: str, output_path: Path) -> GenerationResult:
+        """Generate image using xAI Grok API."""
+        if not HAS_REQUESTS:
+            return GenerationResult(
+                success=False,
+                image_path=None,
+                preview_url=None,
+                error="requests package not installed. Run: pip install requests",
+                prompt_used=prompt,
+            )
+        
+        api_key = os.environ.get('XAI_API_KEY')
+        if not api_key:
+            return GenerationResult(
+                success=False,
+                image_path=None,
+                preview_url=None,
+                error="XAI_API_KEY environment variable not set",
+                prompt_used=prompt,
+            )
+        
+        try:
+            # xAI has a max prompt length of 1024 characters
+            truncated_prompt = prompt[:1000] if len(prompt) > 1000 else prompt
+            self.debug(f"Generating with xAI Grok, prompt: {truncated_prompt[:200]}...")
+            
+            # xAI uses OpenAI-compatible API format
+            response = requests.post(
+                "https://api.x.ai/v1/images/generations",
+                headers={
+                    "Authorization": f"Bearer {api_key}",
+                    "Content-Type": "application/json",
+                },
+                json={
+                    "model": "grok-2-image",
+                    "prompt": truncated_prompt,
+                    "n": 1,
+                },
+                timeout=120,  # 2 minute timeout for image generation
+            )
+            response.raise_for_status()
+            
+            data = response.json()
+            
+            # xAI returns base64-encoded images
+            if 'data' not in data or not data['data']:
+                return GenerationResult(
+                    success=False,
+                    image_path=None,
+                    preview_url=None,
+                    error="No image data in response",
+                    prompt_used=prompt,
+                )
+            
+            image_data = data['data'][0]
+            
+            # Check if it's a URL or base64
+            if 'url' in image_data:
+                # Download from URL
+                img_response = requests.get(image_data['url'], timeout=60)
+                img_response.raise_for_status()
+                output_path.write_bytes(img_response.content)
+            elif 'b64_json' in image_data:
+                # Decode base64
+                import base64
+                image_bytes = base64.b64decode(image_data['b64_json'])
+                output_path.write_bytes(image_bytes)
+            else:
+                return GenerationResult(
+                    success=False,
+                    image_path=None,
+                    preview_url=None,
+                    error="Unexpected response format from xAI",
+                    prompt_used=prompt,
+                )
+            
+            return GenerationResult(
+                success=True,
+                image_path=str(output_path),
+                preview_url=str(output_path.relative_to(self.project_root)),
+                error=None,
+                prompt_used=prompt,
+            )
+            
+        except requests.exceptions.HTTPError as e:
+            error_msg = str(e)
+            try:
+                error_data = e.response.json()
+                self.debug(f"xAI error response: {error_data}")
+                if 'error' in error_data:
+                    error_msg = error_data['error'].get('message', str(error_data['error']))
+                elif 'detail' in error_data:
+                    error_msg = str(error_data['detail'])
+                else:
+                    error_msg = str(error_data)
+            except:
+                # Try to get raw text
+                try:
+                    error_msg = e.response.text[:500]
+                except:
+                    pass
+            return GenerationResult(
+                success=False,
+                image_path=None,
+                preview_url=None,
+                error=f"xAI API error: {error_msg}",
+                prompt_used=prompt,
+            )
+        except Exception as e:
+            return GenerationResult(
+                success=False,
+                image_path=None,
+                preview_url=None,
+                error=str(e),
+                prompt_used=prompt,
+            )
+    
     def generate_image(self, prompt: str, output_path: Path) -> GenerationResult:
         """Generate image using configured provider."""
         if self.provider == "openai":
             return self.generate_image_openai(prompt, output_path)
         elif self.provider == "stability":
             return self.generate_image_stability(prompt, output_path)
+        elif self.provider == "xai":
+            return self.generate_image_xai(prompt, output_path)
         else:
             return GenerationResult(
                 success=False,
@@ -559,9 +703,9 @@ def main():
     )
     parser.add_argument(
         '-p', '--provider',
-        choices=['openai', 'stability'],
+        choices=['openai', 'stability', 'xai'],
         default='openai',
-        help="AI provider for image generation"
+        help="AI provider for image generation (openai, stability, xai)"
     )
     parser.add_argument(
         '-d', '--dry-run',
@@ -593,6 +737,16 @@ def main():
         default='digital art, professional blog illustration, clean design',
         help="Image style prompt"
     )
+    parser.add_argument(
+        '--assets-prefix',
+        default='/assets',
+        help="Prefix to prepend to relative preview paths (default: /assets)"
+    )
+    parser.add_argument(
+        '--no-auto-prefix',
+        action='store_true',
+        help="Disable automatic assets prefix prepending"
+    )
     
     args = parser.parse_args()
     
@@ -606,6 +760,8 @@ def main():
         provider=args.provider,
         output_dir=args.output_dir,
         image_style=args.style,
+        assets_prefix=args.assets_prefix,
+        auto_prefix=not args.no_auto_prefix,
         dry_run=args.dry_run,
         verbose=args.verbose,
         force=args.force,

data/scripts/test/lib/run_tests.sh

@@ -3,8 +3,7 @@
 # Test runner for library unit tests
 # Usage: ./scripts/test/lib/run_tests.sh
 #
-# Note: Requires Bash 4.0+ (for associative arrays in changelog.sh)
-# On macOS: brew install bash
+# Compatible with Bash 3.2+ (macOS default) and Bash 4+
 
 # Note: We intentionally don't use set -e here because test assertions 
 # may return non-zero and we want to continue running tests

data/scripts/update-preview-paths.sh

@@ -0,0 +1,145 @@
+#!/bin/bash
+#
+# update-preview-paths.sh
+# 
+# Updates all preview paths in markdown frontmatter to remove the /assets/ prefix.
+# This aligns with the new auto_prefix feature that automatically prepends /assets/.
+#
+# Usage:
+#   ./scripts/update-preview-paths.sh           # Dry run (preview changes)
+#   ./scripts/update-preview-paths.sh --apply   # Apply changes
+#
+# Example transformation:
+#   preview: /assets/images/previews/my-image.png
+#   becomes:
+#   preview: /images/previews/my-image.png
+#
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Counters
+TOTAL_FILES=0
+MODIFIED_FILES=0
+SKIPPED_FILES=0
+
+# Mode
+DRY_RUN=true
+
+# Parse arguments
+for arg in "$@"; do
+    case $arg in
+        --apply)
+            DRY_RUN=false
+            shift
+            ;;
+        --help|-h)
+            echo "Usage: $0 [--apply]"
+            echo ""
+            echo "Updates preview paths in markdown frontmatter to remove /assets/ prefix."
+            echo ""
+            echo "Options:"
+            echo "  --apply    Apply changes (default is dry run)"
+            echo "  --help     Show this help message"
+            exit 0
+            ;;
+    esac
+done
+
+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_change() {
+    echo -e "${CYAN}[CHANGE]${NC} $1"
+}
+
+echo ""
+echo -e "${BLUE}========================================${NC}"
+echo -e "${BLUE}🔄 Preview Path Updater${NC}"
+echo -e "${BLUE}========================================${NC}"
+echo ""
+
+if [ "$DRY_RUN" = true ]; then
+    log_warning "DRY RUN MODE - No files will be modified"
+    log_info "Run with --apply to make changes"
+else
+    log_warning "APPLY MODE - Files will be modified"
+fi
+echo ""
+
+# Find all markdown files in pages directory
+find "$PROJECT_ROOT/pages" -name "*.md" -type f | while read -r file; do
+    TOTAL_FILES=$((TOTAL_FILES + 1))
+    
+    # Check if file has a preview field with /assets/ prefix
+    if grep -q "^preview: /assets/" "$file" 2>/dev/null; then
+        # Extract current preview path
+        current_path=$(grep "^preview:" "$file" | head -1 | sed 's/^preview: //')
+        
+        # Remove /assets/ prefix
+        new_path=$(echo "$current_path" | sed 's|^/assets/|/|')
+        
+        log_change "$file"
+        echo "  Old: $current_path"
+        echo "  New: $new_path"
+        
+        if [ "$DRY_RUN" = false ]; then
+            # Use sed to replace the preview line
+            if [[ "$OSTYPE" == "darwin"* ]]; then
+                # macOS sed requires empty string for -i
+                sed -i '' "s|^preview: /assets/|preview: /|" "$file"
+            else
+                # Linux sed
+                sed -i "s|^preview: /assets/|preview: /|" "$file"
+            fi
+            log_success "Updated: $file"
+        fi
+        
+        MODIFIED_FILES=$((MODIFIED_FILES + 1))
+    else
+        SKIPPED_FILES=$((SKIPPED_FILES + 1))
+    fi
+done
+
+echo ""
+echo -e "${CYAN}========================================${NC}"
+echo -e "${CYAN}📊 Summary${NC}"
+echo -e "${CYAN}========================================${NC}"
+
+# Re-count since subshell doesn't persist variables
+MODIFIED_COUNT=$(find "$PROJECT_ROOT/pages" -name "*.md" -type f -exec grep -l "^preview: /assets/" {} \; 2>/dev/null | wc -l | tr -d ' ')
+TOTAL_COUNT=$(find "$PROJECT_ROOT/pages" -name "*.md" -type f | wc -l | tr -d ' ')
+
+if [ "$DRY_RUN" = true ]; then
+    echo "  Files to update: $MODIFIED_COUNT"
+    echo "  Total markdown files: $TOTAL_COUNT"
+    echo ""
+    log_info "Run with --apply to make these changes"
+else
+    # After applying, count should be 0
+    REMAINING=$(find "$PROJECT_ROOT/pages" -name "*.md" -type f -exec grep -l "^preview: /assets/" {} \; 2>/dev/null | wc -l | tr -d ' ')
+    echo "  Files updated: $MODIFIED_COUNT"
+    echo "  Files remaining: $REMAINING"
+    echo "  Total markdown files: $TOTAL_COUNT"
+fi
+echo ""

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-12 00:00:00.000000000 Z
+date: 2025-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -81,12 +81,19 @@ files:
 - _data/authors.yml
 - _data/content_statistics.yml
 - _data/generate_statistics.rb
+- _data/generate_statistics.sh
+- _data/github-actions-example.yml
 - _data/navigation/about.yml
 - _data/navigation/docs.yml
 - _data/navigation/home.yml
 - _data/navigation/main.yml
 - _data/navigation/posts.yml
 - _data/navigation/quickstart.yml
+- _data/posts_organization.yml
+- _data/prerequisites.yml
+- _data/statistics_config.yml
+- _data/ui-text.yml
+- _data/update_statistics.sh
 - _includes/README.md
 - _includes/analytics/google-analytics.html
 - _includes/analytics/google-tag-manager-body.html
@@ -176,6 +183,7 @@ files:
 - assets/images/previews/published-documentation-library.png
 - assets/images/previews/quantum-computing-explained-from-qubits-to-quantum.png
 - assets/images/previews/science.png
+- assets/images/previews/site-personalization-configuration.png
 - assets/images/previews/technology.png
 - assets/images/previews/the-complete-guide-to-startup-funding-in-2025.png
 - assets/images/previews/the-remote-work-revolution-how-global-teams-are-re.png
@@ -237,6 +245,7 @@ files:
 - scripts/test/lib/test_validation.sh
 - scripts/test/lib/test_version.sh
 - scripts/test/theme/validate
+- scripts/update-preview-paths.sh
 - scripts/utils/analyze-commits
 - scripts/utils/fix-markdown
 - scripts/utils/setup