jekyll-theme-zer0 0.8.1 → 0.10.3

data/scripts/generate-preview-images.sh

@@ -79,13 +79,6 @@ else
     warn() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
     error() { echo -e "${RED}[ERROR]${NC} $1" >&2; exit 1; }
     debug() { [[ "${VERBOSE:-false}" == "true" ]] && echo -e "${PURPLE}[DEBUG]${NC} $1" >&2 || true; }
-    print_header() {
-        echo ""
-        echo -e "${CYAN}════════════════════════════════════════════════════════════════${NC}"
-        echo -e "  ${GREEN}$1${NC}"
-        echo -e "${CYAN}════════════════════════════════════════════════════════════════${NC}"
-        echo ""
-    }
 fi
 
 # =============================================================================
@@ -577,35 +570,27 @@ update_front_matter() {
     # Create backup
     cp "$file" "$file.bak"
     
-    # Always use sed for reliability (yq can fail on complex YAML)
     # Check if preview field exists
     if grep -q "^preview:" "$file"; then
-        # Update existing preview field using sed
-        if [[ "$(uname)" == "Darwin" ]]; then
-            # macOS sed requires empty string for -i
-            sed -i '' "s|^preview:.*|preview: $preview_path|" "$file"
+        # Update existing preview field
+        if [[ "$YAML_PARSER" == "yq" ]]; then
+            # Use yq for in-place update
+            yq -i ".preview = \"$preview_path\"" "$file"
         else
-            sed -i "s|^preview:.*|preview: $preview_path|" "$file"
+            # Use sed for simple replacement
+            sed -i.tmp "s|^preview:.*|preview: $preview_path|" "$file"
+            rm -f "$file.tmp"
         fi
     else
         # Add preview field after description or title
         if grep -q "^description:" "$file"; then
-            if [[ "$(uname)" == "Darwin" ]]; then
-                sed -i '' "/^description:/a\\
-preview: $preview_path" "$file"
-            else
-                sed -i "/^description:/a\\
+            sed -i.tmp "/^description:/a\\
 preview: $preview_path" "$file"
-            fi
         else
-            if [[ "$(uname)" == "Darwin" ]]; then
-                sed -i '' "/^title:/a\\
-preview: $preview_path" "$file"
-            else
-                sed -i "/^title:/a\\
+            sed -i.tmp "/^title:/a\\
 preview: $preview_path" "$file"
-            fi
         fi
+        rm -f "$file.tmp"
     fi
     
     # Remove backup on success
@@ -740,54 +725,6 @@ main() {
     echo "  List Only: $LIST_ONLY"
     echo ""
     
-    # Get configured collections from _config.yml
-    get_configured_collections() {
-        local collections=()
-        local in_preview_images=false
-        local in_collections=false
-        
-        while IFS= read -r line; do
-            if [[ "$line" =~ ^preview_images: ]]; then
-                in_preview_images=true
-                continue
-            fi
-            if [[ "$in_preview_images" == true && "$line" =~ ^[[:space:]]+collections: ]]; then
-                in_collections=true
-                continue
-            fi
-            if [[ "$in_collections" == true && "$line" =~ ^[[:space:]]+- ]]; then
-                local collection="${line#*- }"
-                collection="${collection%%#*}"
-                collection="${collection%"${collection##*[![:space:]]}"}"
-                collections+=("$collection")
-            elif [[ "$in_collections" == true && ! "$line" =~ ^[[:space:]]+-  && ! "$line" =~ ^[[:space:]]*$ ]]; then
-                break
-            fi
-            if [[ "$in_preview_images" == true && "$line" =~ ^[a-zA-Z_]+: && ! "$line" =~ ^[[:space:]] ]]; then
-                break
-            fi
-        done < "$CONFIG_FILE"
-        
-        if [[ ${#collections[@]} -eq 0 ]]; then
-            collections=("posts" "quickstart" "docs")
-        fi
-        
-        echo "${collections[@]}"
-    }
-    
-    # Process a collection by name
-    process_collection_by_name() {
-        local name="$1"
-        local path="$PROJECT_ROOT/pages/_${name}"
-        
-        if [[ -d "$path" ]]; then
-            step "Processing ${name} collection..."
-            process_collection "$path"
-        else
-            warn "Collection directory not found: $path"
-        fi
-    }
-    
     # Process files
     if [[ -n "$SPECIFIC_FILE" ]]; then
         # Process single file
@@ -797,27 +734,35 @@ main() {
         process_file "$PROJECT_ROOT/$SPECIFIC_FILE"
     elif [[ -n "$COLLECTION" ]]; then
         # Process specific collection
-        if [[ "$COLLECTION" == "all" ]]; then
-            step "Processing all configured collections..."
-            for col in $(get_configured_collections); do
-                process_collection_by_name "$col"
-            done
-        else
-            # Check if collection directory exists
-            local collection_path="$PROJECT_ROOT/pages/_${COLLECTION}"
-            if [[ -d "$collection_path" ]]; then
-                process_collection_by_name "$COLLECTION"
-            else
-                local available=$(get_configured_collections | tr ' ' ', ')
-                error "Unknown collection: $COLLECTION. Available: $available, all"
-            fi
-        fi
+        case "$COLLECTION" in
+            posts)
+                step "Processing posts collection..."
+                process_collection "$PROJECT_ROOT/pages/_posts"
+                ;;
+            quickstart)
+                step "Processing quickstart collection..."
+                process_collection "$PROJECT_ROOT/pages/_quickstart"
+                ;;
+            docs)
+                step "Processing docs collection..."
+                process_collection "$PROJECT_ROOT/pages/_docs"
+                ;;
+            all)
+                step "Processing all collections..."
+                process_collection "$PROJECT_ROOT/pages/_posts"
+                process_collection "$PROJECT_ROOT/pages/_quickstart"
+                process_collection "$PROJECT_ROOT/pages/_docs"
+                ;;
+            *)
+                error "Unknown collection: $COLLECTION. Use: posts, quickstart, docs, or all"
+                ;;
+        esac
     else
-        # Process all configured collections by default
-        step "Processing all configured collections..."
-        for col in $(get_configured_collections); do
-            process_collection_by_name "$col"
-        done
+        # Process all content by default
+        step "Processing all content collections..."
+        process_collection "$PROJECT_ROOT/pages/_posts"
+        process_collection "$PROJECT_ROOT/pages/_quickstart"
+        process_collection "$PROJECT_ROOT/pages/_docs"
     fi
     
     # Print summary

data/scripts/lib/README.md

@@ -9,9 +9,11 @@ This directory contains focused, single-responsibility libraries that power the
 ## Libraries
 
 ### 📦 `common.sh` - Shared Utilities
+
 Core utilities used by all other libraries.
 
 **Functions:**
+
 - `log()`, `info()`, `warn()`, `error()` - Colored logging
 - `confirm()` - User confirmation prompts
 - `dry_run_exec()` - Dry run wrapper for commands
@@ -19,15 +21,18 @@ Core utilities used by all other libraries.
 - `get_repo_root()` - Find repository root directory
 
 **Usage:**
+
 ```bash
 source "$(dirname "$0")/lib/common.sh"
 log "Starting process..."
 ```
 
 ### 🔍 `validation.sh` - Environment Validation
+
 Validates environment, dependencies, and prerequisites.
 
 **Functions:**
+
 - `validate_git_repo()` - Verify git repository
 - `validate_clean_working_dir()` - Check for uncommitted changes
 - `validate_required_files()` - Check required files exist
@@ -36,15 +41,18 @@ Validates environment, dependencies, and prerequisites.
 - `validate_environment()` - Comprehensive validation
 
 **Usage:**
+
 ```bash
 source "$(dirname "$0")/lib/validation.sh"
 validate_environment false false  # skip_publish=false, require_gh=false
 ```
 
 ### 📝 `version.sh` - Version Management
+
 Read, calculate, and update semantic versions.
 
 **Functions:**
+
 - `get_current_version()` - Read version from version.rb
 - `calculate_new_version()` - Calculate new version (major/minor/patch)
 - `update_version_files()` - Update all version files
@@ -52,6 +60,7 @@ Read, calculate, and update semantic versions.
 - `version_less_than()` - Compare two versions
 
 **Usage:**
+
 ```bash
 source "$(dirname "$0")/lib/version.sh"
 
@@ -61,15 +70,18 @@ update_version_files "$new"
 ```
 
 ### 📋 `changelog.sh` - Changelog Generation
+
 Generate changelogs from conventional commits.
 
 **Functions:**
+
 - `generate_changelog()` - Generate changelog for version
 - `categorize_commit()` - Categorize commit by type
 - `clean_commit_message()` - Clean conventional commit prefixes
 - `extract_release_notes()` - Extract notes for specific version
 
 **Commit Categories:**
+
 - `feat:` → Added
 - `fix:` → Fixed
 - `BREAKING:` → Breaking Changes
@@ -78,6 +90,7 @@ Generate changelogs from conventional commits.
 - `security:` → Security
 
 **Usage:**
+
 ```bash
 source "$(dirname "$0")/lib/changelog.sh"
 
@@ -85,9 +98,11 @@ generate_changelog "1.2.0" "v1.1.0" "HEAD"
 ```
 
 ### 🔄 `git.sh` - Git Operations
+
 Git commits, tags, and repository operations.
 
 **Functions:**
+
 - `get_last_version_tag()` - Find last version tag
 - `commit_and_tag()` - Create release commit and tag
 - `push_changes()` - Push to remote with tags
@@ -95,6 +110,7 @@ Git commits, tags, and repository operations.
 - `get_repo_info()` - Extract owner/repo from URL
 
 **Usage:**
+
 ```bash
 source "$(dirname "$0")/lib/git.sh"
 
@@ -103,9 +119,11 @@ push_changes "origin" "main"
 ```
 
 ### 💎 `gem.sh` - Gem Operations
+
 Build, test, publish, and release gems.
 
 **Functions:**
+
 - `build_gem()` - Build the gem package
 - `publish_gem()` - Publish to RubyGems
 - `create_github_release()` - Create GitHub release
@@ -113,6 +131,7 @@ Build, test, publish, and release gems.
 - `gem_version_exists()` - Check if version exists on RubyGems
 
 **Usage:**
+
 ```bash
 source "$(dirname "$0")/lib/gem.sh"
 
@@ -127,11 +146,13 @@ create_github_release "1.2.0"
 Each library has comprehensive unit tests in `test/`.
 
 ### Run All Tests
+
 ```bash
 ./scripts/lib/test/run_tests.sh
 ```
 
 ### Run Individual Tests
+
 ```bash
 ./scripts/lib/test/test_version.sh
 ./scripts/lib/test/test_changelog.sh
@@ -139,6 +160,7 @@ Each library has comprehensive unit tests in `test/`.
 ```
 
 ### Test Coverage
+
 - ✅ Version calculations and validation
 - ✅ Changelog generation and categorization
 - ✅ Git operations and tag management
@@ -178,30 +200,30 @@ source "$LIB_DIR/gem.sh"
 # Main workflow
 main() {
     print_header "Custom Release"
-    
+
     # Validate
     validate_environment
-    
+
     # Version
     local current=$(get_current_version)
     local new=$(calculate_new_version "$current" "patch")
     update_version_files "$new"
-    
+
     # Changelog
     generate_changelog "$new"
-    
+
     # Build & Test
     build_gem "$new"
     run_tests
-    
+
     # Commit & Tag
     commit_and_tag "$new"
-    
+
     # Publish
     publish_gem "$new"
     create_github_release "$new"
     push_changes
-    
+
     success "Release $new complete!"
 }
 
@@ -211,18 +233,23 @@ main "$@"
 ## Architecture Benefits
 
 ### ✅ Modularity
+
 Each library has ONE responsibility - easy to understand and modify.
 
 ### ✅ Testability
+
 Small, focused functions can be unit tested independently.
 
 ### ✅ Reusability
+
 Libraries can be used in different scripts or GitHub Actions.
 
 ### ✅ Maintainability
+
 Changes isolated to specific files - less ripple effect.
 
 ### ✅ Clarity
+
 Functions have clear names and single purposes.
 
 ## Migrating Old Scripts
@@ -234,6 +261,7 @@ Old monolithic scripts (`gem-publish.sh`, `release.sh`, `build.sh`) can now be:
 3. **Removed** once adoption is confirmed
 
 Example deprecation wrapper:
+
 ```bash
 #!/bin/bash
 echo "⚠️  WARNING: This script is deprecated"

data/scripts/lib/preview_generator.py

@@ -234,13 +234,13 @@ class PreviewGenerator:
         return safe_name[:50]  # Limit length
     
     def generate_image_openai(self, prompt: str, output_path: Path) -> GenerationResult:
-        """Generate image using OpenAI DALL-E."""
-        if not HAS_OPENAI:
+        """Generate image using OpenAI DALL-E via HTTP API (no SDK required)."""
+        if not HAS_REQUESTS:
             return GenerationResult(
                 success=False,
                 image_path=None,
                 preview_url=None,
-                error="openai package not installed. Run: pip install openai",
+                error="requests package not installed. Run: pip install requests",
                 prompt_used=prompt,
             )
         
@@ -255,8 +255,6 @@ class PreviewGenerator:
             )
         
         try:
-            client = OpenAI(api_key=api_key)
-            
             self.debug(f"Generating with prompt: {prompt[:200]}...")
             
             # Parse size
@@ -267,27 +265,29 @@ class PreviewGenerator:
             }
             size = size_map.get(self.image_size, "1024x1024")
             
-            response = client.images.generate(
-                model="dall-e-3",
-                prompt=prompt,
-                size=size,
-                quality="standard",
-                n=1,
+            # Use HTTP API directly instead of SDK
+            response = requests.post(
+                "https://api.openai.com/v1/images/generations",
+                headers={
+                    "Authorization": f"Bearer {api_key}",
+                    "Content-Type": "application/json",
+                },
+                json={
+                    "model": "dall-e-3",
+                    "prompt": prompt,
+                    "size": size,
+                    "quality": "standard",
+                    "n": 1,
+                },
+                timeout=120,  # 2 minute timeout for image generation
             )
+            response.raise_for_status()
             
-            image_url = response.data[0].url
+            data = response.json()
+            image_url = data['data'][0]['url']
             
             # Download image
-            if not HAS_REQUESTS:
-                return GenerationResult(
-                    success=False,
-                    image_path=None,
-                    preview_url=image_url,
-                    error="requests package not installed. Run: pip install requests",
-                    prompt_used=prompt,
-                )
-            
-            img_response = requests.get(image_url)
+            img_response = requests.get(image_url, timeout=60)
             img_response.raise_for_status()
             
             output_path.write_bytes(img_response.content)
@@ -300,6 +300,21 @@ class PreviewGenerator:
                 prompt_used=prompt,
             )
             
+        except requests.exceptions.HTTPError as e:
+            error_msg = str(e)
+            try:
+                error_data = e.response.json()
+                if 'error' in error_data:
+                    error_msg = error_data['error'].get('message', str(e))
+            except:
+                pass
+            return GenerationResult(
+                success=False,
+                image_path=None,
+                preview_url=None,
+                error=error_msg,
+                prompt_used=prompt,
+            )
         except Exception as e:
             return GenerationResult(
                 success=False,