jekyll-theme-zer0 0.8.1 → 0.10.0

data/scripts/utils/fix-markdown

@@ -0,0 +1,251 @@
+#!/usr/bin/env bash
+
+#
+# Markdown Formatting Fix Script
+# Addresses common markdown linting violations across the repository
+#
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+PROJECT_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+# Aliases for backward compatibility with logging function names
+log_info() { info "$@"; }
+log_success() { success "$@"; }
+log_warning() { warn "$@"; }
+log_error() { error "$@"; }
+
+# Function to fix common markdown issues
+fix_markdown_file() {
+    local file="$1"
+    local temp_file="${file}.tmp"
+    
+    info "Fixing markdown formatting in: $file"
+    
+    # Create backup
+    cp "$file" "${file}.backup"
+    
+    # Apply fixes using sed (macOS compatible)
+    sed -e 's/[[:space:]]*$//' \
+        -e '/^#/a\
+' \
+        -e '/^##/a\
+' \
+        -e '/^###/a\
+' \
+        -e '/^####/a\
+' \
+        -e '/^#####/a\
+' \
+        -e '/^######/a\
+' \
+        -e '/^- /i\
+' \
+        -e '/^* /i\
+' \
+        -e '/^+ /i\
+' \
+        -e '/^[0-9]/i\
+' \
+        -e 's/```$/```bash/' \
+        -e 's/^```[[:space:]]*$/```bash/' \
+        "$file" > "$temp_file"
+    
+    # Additional fixes with awk for more complex patterns
+    awk '
+    BEGIN { prev_was_heading = 0; prev_was_list = 0 }
+    
+    # Handle headings - ensure blank line before and after
+    /^#/ {
+        if (NR > 1 && prev_line != "" && !prev_was_heading) print ""
+        print $0
+        prev_was_heading = 1
+        prev_was_list = 0
+        prev_line = $0
+        next
+    }
+    
+    # Handle list items - ensure blank line before first item
+    /^[[:space:]]*[-*+]/ || /^[[:space:]]*[0-9]+\./ {
+        if (!prev_was_list && prev_line != "" && !prev_was_heading) print ""
+        print $0
+        prev_was_list = 1
+        prev_was_heading = 0
+        prev_line = $0
+        next
+    }
+    
+    # Handle code blocks - ensure they have language specification
+    /^```[[:space:]]*$/ {
+        print "```bash"
+        prev_was_heading = 0
+        prev_was_list = 0
+        prev_line = $0
+        next
+    }
+    
+    # Regular lines
+    {
+        print $0
+        prev_was_heading = 0
+        prev_was_list = 0
+        prev_line = $0
+    }
+    ' "$temp_file" > "$file"
+    
+    # Clean up
+    rm "$temp_file"
+    
+    log_success "Fixed formatting in: $file"
+}
+
+# Function to remove trailing whitespace
+remove_trailing_whitespace() {
+    local file="$1"
+    log_info "Removing trailing whitespace from: $file"
+    
+    # Remove trailing whitespace
+    sed -i '' 's/[[:space:]]*$//' "$file"
+    
+    log_success "Removed trailing whitespace from: $file"
+}
+
+# Function to fix heading punctuation
+fix_heading_punctuation() {
+    local file="$1"
+    log_info "Fixing heading punctuation in: $file"
+    
+    # Remove trailing punctuation from headings
+    sed -i '' 's/^\(#\+[[:space:]]*.*\)[.!?:;,]*[[:space:]]*$/\1/' "$file"
+    
+    log_success "Fixed heading punctuation in: $file"
+}
+
+# Function to fix emphasis formatting
+fix_emphasis_formatting() {
+    local file="$1"
+    log_info "Fixing emphasis formatting in: $file"
+    
+    # Fix common emphasis issues
+    sed -i '' \
+        -e 's/\*\*\([^*]*\) \*\*/\*\*\1\*\*/g' \
+        -e 's/\*\([^*]*\) \*/\*\1\*/g' \
+        "$file"
+    
+    log_success "Fixed emphasis formatting in: $file"
+}
+
+# Main execution function
+main() {
+    log_info "Starting markdown formatting fixes..."
+    
+    # Find all markdown files
+    local md_files
+    mapfile -t md_files < <(find "$PROJECT_ROOT" -name "*.md" \
+        -not -path "*/node_modules/*" \
+        -not -path "*/.git/*" \
+        -not -path "*/vendor/*" \
+        -not -path "*/_site/*")
+    
+    if [ ${#md_files[@]} -eq 0 ]; then
+        log_warning "No markdown files found"
+        return 0
+    fi
+    
+    log_info "Found ${#md_files[@]} markdown files to process"
+    
+    # Process each file
+    for file in "${md_files[@]}"; do
+        if [ -f "$file" ]; then
+            remove_trailing_whitespace "$file"
+            fix_heading_punctuation "$file"
+            fix_emphasis_formatting "$file"
+            fix_markdown_file "$file"
+        fi
+    done
+    
+    log_success "Completed markdown formatting fixes for ${#md_files[@]} files"
+    
+    # Provide summary
+    echo
+    log_info "Summary of fixes applied:"
+    echo "  ✓ Removed trailing whitespace"
+    echo "  ✓ Added blank lines around headings"
+    echo "  ✓ Added blank lines before list items"
+    echo "  ✓ Fixed code block language specifications"
+    echo "  ✓ Fixed heading punctuation"
+    echo "  ✓ Fixed emphasis formatting"
+    echo
+    log_info "Backup files created with .backup extension"
+    log_info "Run 'git diff' to review changes before committing"
+}
+
+# Help function
+show_help() {
+    cat << EOF
+Markdown Formatting Fix Script
+
+USAGE:
+    $0 [OPTIONS]
+
+OPTIONS:
+    -h, --help     Show this help message
+    --dry-run      Show what would be fixed without making changes
+    --file FILE    Fix only the specified file
+
+EXAMPLES:
+    $0                          # Fix all markdown files
+    $0 --file README.md         # Fix only README.md
+    $0 --dry-run               # Preview changes without applying
+
+This script fixes common markdown linting violations:
+- Trailing whitespace
+- Missing blank lines around headings
+- Missing blank lines before lists
+- Code blocks without language specification
+- Heading punctuation issues
+- Emphasis formatting problems
+
+EOF
+}
+
+# Parse command line arguments
+case "${1:-}" in
+    -h|--help)
+        show_help
+        exit 0
+        ;;
+    --dry-run)
+        log_info "DRY RUN MODE - No changes will be made"
+        # Implementation for dry run would go here
+        exit 0
+        ;;
+    --file)
+        if [ -n "${2:-}" ] && [ -f "$2" ]; then
+            log_info "Fixing single file: $2"
+            remove_trailing_whitespace "$2"
+            fix_heading_punctuation "$2"
+            fix_emphasis_formatting "$2"
+            fix_markdown_file "$2"
+            log_success "Completed fixing: $2"
+        else
+            log_error "File not found: ${2:-}"
+            exit 1
+        fi
+        exit 0
+        ;;
+    "")
+        main
+        ;;
+    *)
+        log_error "Unknown option: $1"
+        show_help
+        exit 1
+        ;;
+esac

data/scripts/utils/setup

@@ -0,0 +1,137 @@
+#!/bin/bash
+
+# Development setup script for zer0-mistakes Jekyll theme
+# Usage: ./scripts/utils/setup
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+log "Setting up zer0-mistakes Jekyll theme development environment..."
+
+# Check system requirements
+log "Checking system requirements..."
+
+# Check Ruby
+if ! command -v ruby &> /dev/null; then
+    error "Ruby is not installed. Please install Ruby >= 2.7.0"
+fi
+
+RUBY_VERSION=$(ruby --version | awk '{print $2}')
+log "Ruby version: $RUBY_VERSION"
+
+# Check Bundler
+if ! command -v bundle &> /dev/null; then
+    log "Installing Bundler..."
+    gem install bundler
+fi
+
+# Check jq
+if ! command -v jq &> /dev/null; then
+    warn "jq is not installed. Installing via Homebrew (macOS)..."
+    if command -v brew &> /dev/null; then
+        brew install jq
+    else
+        error "jq is required but not installed. Please install jq manually."
+    fi
+fi
+
+# Check Git
+if ! command -v git &> /dev/null; then
+    error "Git is not installed"
+fi
+
+# Install dependencies
+log "Installing Ruby dependencies..."
+bundle install
+
+# Make scripts executable
+log "Making scripts executable..."
+chmod +x scripts/*.sh
+
+# Validate gemspec
+log "Validating gemspec..."
+if gem specification jekyll-theme-zer0.gemspec > /dev/null 2>&1; then
+    info "✓ Gemspec is valid"
+else
+    error "Gemspec validation failed"
+fi
+
+# Create CHANGELOG if it doesn't exist
+if [[ ! -f "CHANGELOG.md" ]]; then
+    log "Creating CHANGELOG.md..."
+    cat > CHANGELOG.md << 'EOF'
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial development setup
+
+EOF
+fi
+
+# Create .gitignore additions for gem development
+if ! grep -q "*.gem" .gitignore 2>/dev/null; then
+    log "Adding gem development entries to .gitignore..."
+    cat >> .gitignore << 'EOF'
+
+# Gem development
+*.gem
+.bundle/
+vendor/
+pkg/
+EOF
+fi
+
+# Setup Git hooks (optional)
+if [[ -d ".git" ]]; then
+    log "Setting up Git hooks..."
+    mkdir -p .git/hooks
+    
+    # Pre-commit hook to run basic validations
+    cat > .git/hooks/pre-commit << 'EOF'
+#!/bin/bash
+# Pre-commit hook for zer0-mistakes Jekyll theme
+
+echo "Running pre-commit validations..."
+
+# Validate gemspec
+if ! gem specification jekyll-theme-zer0.gemspec > /dev/null 2>&1; then
+    echo "❌ Gemspec validation failed"
+    exit 1
+fi
+
+# Check if package.json version is valid
+if ! jq -e '.version' package.json > /dev/null 2>&1; then
+    echo "❌ Invalid version in package.json"
+    exit 1
+fi
+
+echo "✅ Pre-commit validations passed"
+EOF
+    chmod +x .git/hooks/pre-commit
+fi
+
+log "Setup complete!"
+log ""
+log "Available commands:"
+log "  ./scripts/version.sh [patch|minor|major]  - Bump version"
+log "  ./scripts/build.sh [--publish]            - Build (and optionally publish) gem"
+log "  ./scripts/test.sh                         - Run tests"
+log ""
+log "Development workflow:"
+log "1. Make your changes"
+log "2. Run ./scripts/test.sh to validate"
+log "3. Run ./scripts/version.sh to bump version"
+log "4. Run ./scripts/build.sh --publish to release"

data/scripts/version.sh

@@ -1,10 +1,36 @@
 #!/bin/bash
 
+# ============================================================================
+# DEPRECATED: This script is deprecated and will be removed in a future release.
+# 
+# Please use the modular release system instead:
+#   - For version management: source scripts/lib/version.sh
+#   - For full release workflow: scripts/bin/release [patch|minor|major]
+#
+# The new system provides:
+#   - Better error handling and dry-run support
+#   - Automatic changelog generation from commits
+#   - Modular library architecture
+#   - Comprehensive testing
+#
+# This script will continue to work but is no longer maintained.
+# ============================================================================
+
 # Version management script for zer0-mistakes Jekyll theme
 # Usage: ./scripts/version.sh [patch|minor|major] [--dry-run]
 
 set -e
 
+# Show deprecation warning
+echo ""
+echo "⚠️  DEPRECATION WARNING: scripts/version.sh is deprecated."
+echo "   Please use 'scripts/bin/release' instead for the full release workflow."
+echo "   Or source 'scripts/lib/version.sh' for version management functions."
+echo ""
+echo "   Continuing in 3 seconds... (Press Ctrl+C to abort)"
+sleep 3
+echo ""
+
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-11-27 00:00:00.000000000 Z
+date: 2025-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -181,13 +181,15 @@ files:
 - assets/particles.json
 - scripts/README.md
 - scripts/analyze-commits.sh
+- scripts/bin/build
+- scripts/bin/release
+- scripts/bin/test
 - scripts/build
-- scripts/build.sh
-- scripts/build.sh.legacy
 - scripts/example-usage.sh
+- scripts/features/generate-preview-images
+- scripts/features/install-preview-generator
+- scripts/features/preview_generator.py
 - scripts/fix-markdown-format.sh
-- scripts/gem-publish.sh
-- scripts/gem-publish.sh.legacy
 - scripts/generate-preview-images.sh
 - scripts/install-preview-generator.sh
 - scripts/lib/README.md
@@ -205,12 +207,22 @@ files:
 - scripts/lib/validation.sh
 - scripts/lib/version.sh
 - scripts/release
-- scripts/release.sh
-- scripts/release.sh.legacy
 - scripts/setup.sh
 - scripts/test-auto-version.sh
 - scripts/test-mermaid.sh
 - scripts/test.sh
+- scripts/test/integration/auto-version
+- scripts/test/integration/mermaid
+- scripts/test/lib/run_tests.sh
+- scripts/test/lib/test_changelog.sh
+- scripts/test/lib/test_gem.sh
+- scripts/test/lib/test_git.sh
+- scripts/test/lib/test_validation.sh
+- scripts/test/lib/test_version.sh
+- scripts/test/theme/validate
+- scripts/utils/analyze-commits
+- scripts/utils/fix-markdown
+- scripts/utils/setup
 - scripts/version.sh
 homepage: https://github.com/bamr87/zer0-mistakes
 licenses:

data/scripts/build.sh

@@ -1,33 +0,0 @@
-#!/bin/bash
-
-# DEPRECATED: This script is deprecated and will be removed in v0.8.0
-# Please use the new simplified build command instead.
-
-set -e
-
-# Colors
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-echo -e "${YELLOW}╔════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${YELLOW}║  ⚠️  DEPRECATION WARNING                                   ║${NC}"
-echo -e "${YELLOW}╚════════════════════════════════════════════════════════════╝${NC}"
-echo ""
-echo -e "${YELLOW}This script (build.sh) is deprecated and will be removed in v0.8.0${NC}"
-echo ""
-echo -e "Please use the new simplified command instead:"
-echo -e "  ${CYAN}./scripts/build${NC} [options]"
-echo ""
-echo -e "The new command is:"
-echo -e "  ✅ Simpler and more focused"
-echo -e "  ✅ Uses modular libraries"
-echo -e "  ✅ Better error handling"
-echo -e "  ✅ Fully tested"
-echo ""
-echo -e "${YELLOW}Redirecting to new command in 3 seconds...${NC}"
-sleep 3
-echo ""
-
-# Redirect to new command
-exec "$(dirname "$0")/build" "$@"

data/scripts/build.sh.legacy

@@ -1,174 +0,0 @@
-#!/bin/bash
-
-# Build and publish script for zer0-mistakes Jekyll theme
-# Usage: ./scripts/build.sh [--publish] [--dry-run]
-
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Default values
-PUBLISH=false
-DRY_RUN=false
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --publish)
-            PUBLISH=true
-            shift
-            ;;
-        --dry-run)
-            DRY_RUN=true
-            shift
-            ;;
-        *)
-            echo -e "${RED}Unknown option: $1${NC}"
-            exit 1
-            ;;
-    esac
-done
-
-# Function to log messages
-log() {
-    echo -e "${GREEN}[BUILD]${NC} $1"
-}
-
-warn() {
-    echo -e "${YELLOW}[WARNING]${NC} $1"
-}
-
-error() {
-    echo -e "${RED}[ERROR]${NC} $1"
-    exit 1
-}
-
-info() {
-    echo -e "${BLUE}[INFO]${NC} $1"
-}
-
-# Check if gemspec exists
-if [[ ! -f "jekyll-theme-zer0.gemspec" ]]; then
-    error "jekyll-theme-zer0.gemspec not found"
-fi
-
-# Check if package.json exists
-if [[ ! -f "package.json" ]]; then
-    error "package.json not found"
-fi
-
-# Get version from package.json
-VERSION=$(jq -r '.version' package.json)
-if [[ "$VERSION" == "null" ]]; then
-    error "Could not read version from package.json"
-fi
-
-log "Building jekyll-theme-zer0 version $VERSION"
-
-# Create build directory
-log "Creating build directory..."
-mkdir -p build
-
-# Clean up old gem files
-log "Cleaning up old gem files..."
-rm -f jekyll-theme-zer0-*.gem
-rm -f build/jekyll-theme-zer0-*.gem
-
-# Validate dependencies
-log "Checking dependencies..."
-if ! command -v bundle &> /dev/null; then
-    error "Bundler is not installed. Run 'gem install bundler' first."
-fi
-
-if ! command -v jq &> /dev/null; then
-    error "jq is not installed. Run 'brew install jq' (macOS) or appropriate package manager."
-fi
-
-# Run bundle install to ensure dependencies are up to date
-log "Installing/updating dependencies..."
-if [[ "$DRY_RUN" != true ]]; then
-    bundle install
-fi
-
-# Validate gemspec
-log "Validating gemspec..."
-if [[ "$DRY_RUN" != true ]]; then
-    ruby -c jekyll-theme-zer0.gemspec > /dev/null
-    info "✓ Gemspec is valid"
-fi
-
-# Build the gem
-log "Building gem..."
-if [[ "$DRY_RUN" == true ]]; then
-    log "Dry run mode - would build jekyll-theme-zer0-${VERSION}.gem"
-else
-    if gem build jekyll-theme-zer0.gemspec; then
-        # Move gem to build directory
-        mv jekyll-theme-zer0-${VERSION}.gem build/
-        info "✓ Successfully built jekyll-theme-zer0-${VERSION}.gem"
-    else
-        error "Failed to build gem"
-    fi
-fi
-
-# List gem contents for verification
-if [[ "$DRY_RUN" != true ]] && [[ -f "build/jekyll-theme-zer0-${VERSION}.gem" ]]; then
-    log "Gem contents:"
-    # Use tar to list contents since gem contents only works for installed gems
-    tar -tzf build/jekyll-theme-zer0-${VERSION}.gem | head -20
-    echo "..."
-    echo "Total files: $(tar -tzf build/jekyll-theme-zer0-${VERSION}.gem | wc -l)"
-fi
-
-# Check if we should publish
-if [[ "$PUBLISH" == true ]]; then
-    if [[ "$DRY_RUN" == true ]]; then
-        log "Dry run mode - would publish jekyll-theme-zer0-${VERSION}.gem to RubyGems"
-    else
-        log "Publishing gem to RubyGems..."
-        
-        # Check if user is authenticated with RubyGems
-        if [[ ! -f ~/.gem/credentials ]]; then
-            error "Not authenticated with RubyGems. Run 'gem signin' first."
-        fi
-        
-        # Check if this version already exists on RubyGems
-        if gem list --remote jekyll-theme-zer0 | grep -q "jekyll-theme-zer0 (${VERSION})"; then
-            warn "Version ${VERSION} already exists on RubyGems"
-            echo -e "${YELLOW}You need to bump the version first. Use ./scripts/version.sh --bump [--major|--minor|--patch]${NC}"
-            error "Cannot republish existing version ${VERSION}"
-        fi
-        
-        # Confirm publication
-        echo -e "${YELLOW}Are you sure you want to publish jekyll-theme-zer0-${VERSION}.gem to RubyGems? (y/N)${NC}"
-        read -r response
-        if [[ "$response" =~ ^[Yy]$ ]]; then
-            if gem push build/jekyll-theme-zer0-${VERSION}.gem; then
-                info "✓ Successfully published jekyll-theme-zer0-${VERSION}.gem"
-                log "Gem is now available at: https://rubygems.org/gems/jekyll-theme-zer0"
-            else
-                error "Failed to publish gem"
-            fi
-        else
-            log "Publication cancelled"
-        fi
-    fi
-else
-    log "Build complete! Gem file: jekyll-theme-zer0-${VERSION}.gem"
-    log "To publish, run: ./scripts/build.sh --publish"
-fi
-
-# Cleanup option
-if [[ "$PUBLISH" == true ]] && [[ "$DRY_RUN" != true ]]; then
-    echo -e "${YELLOW}Remove local gem file? (y/N)${NC}"
-    read -r response
-    if [[ "$response" =~ ^[Yy]$ ]]; then
-        rm -f build/jekyll-theme-zer0-${VERSION}.gem
-        log "Local gem file removed"
-    fi
-fi