jekyll-theme-zer0 0.15.0 → 0.15.2

data/_data/generate_statistics.rb

@@ -5,10 +5,13 @@ require 'yaml'
 require 'date'
 require 'fileutils'
 
-# Statistics Generator for Jekyll Site
+# Enhanced Statistics Generator for Jekyll Site
 # Analyzes site content and generates comprehensive statistics
+# Features: focus areas, skill levels, authors, content types analysis
 
 class SiteStatisticsGenerator
+  CONFIG_FILE = '_data/statistics_config.yml'
+
   def initialize(site_root = '.')
     @site_root = File.expand_path(site_root)
     @posts_dir = File.join(@site_root, '_posts')
@@ -19,15 +22,63 @@ class SiteStatisticsGenerator
       File.join(@site_root, '_projects')
     ]
     @output_file = File.join(@site_root, '_data', 'content_statistics.yml')
+    @config_file = File.join(@site_root, CONFIG_FILE)
+    
+    # Load configuration
+    @config = load_config
     
     @stats = {
       'generated_at' => Time.now.strftime('%Y-%m-%d %H:%M:%S'),
       'overview' => {},
       'categories' => {},
       'tags' => {},
+      'authors' => {},
+      'years' => {},
       'content_breakdown' => {},
       'monthly_distribution' => {},
-      'word_statistics' => {}
+      'word_statistics' => {},
+      'focus_areas' => {},
+      'skill_levels' => {},
+      'content_types' => {},
+      'date_range' => {},
+      'drafts' => 0,
+      'published' => 0
+    }
+  end
+
+  def load_config
+    if File.exist?(@config_file)
+      puts "📋 Loading configuration from #{CONFIG_FILE}..."
+      YAML.load_file(@config_file)
+    else
+      puts "⚠️  Configuration file not found: #{CONFIG_FILE}"
+      puts "📝 Using default configuration..."
+      default_config
+    end
+  end
+
+  def default_config
+    {
+      'focus_areas' => {
+        'AI & Machine Learning' => ['ai', 'ml', 'machine-learning'],
+        'Web Development' => ['web', 'javascript', 'jekyll'],
+        'DevOps & Infrastructure' => ['devops', 'docker', 'ci/cd'],
+        'System Administration' => ['linux', 'windows', 'system'],
+        'Programming & Scripting' => ['programming', 'python', 'bash', 'ruby'],
+        'Data & Analytics' => ['data', 'database', 'analytics']
+      },
+      'skill_levels' => {
+        'beginner' => ['beginner', 'intro', 'basics', 'quickstart'],
+        'intermediate' => ['intermediate', 'practical', 'hands-on'],
+        'advanced' => ['advanced', 'expert', 'architecture'],
+        'expert' => ['expert', 'research', 'innovation']
+      },
+      'content_types' => {
+        'Tutorial' => ['tutorial', 'guide', 'how-to'],
+        'Article' => ['article', 'analysis', 'insights'],
+        'Journal Entry' => ['journal', 'learning-journey', 'post'],
+        'Documentation' => ['documentation', 'reference', 'docs']
+      }
     }
   end
 
@@ -38,6 +89,7 @@ class SiteStatisticsGenerator
     analyze_pages
     analyze_collections
     calculate_overview_metrics
+    calculate_derived_stats
     sort_and_finalize_data
     write_statistics_file
     
@@ -123,7 +175,12 @@ class SiteStatisticsGenerator
     end
 
     # Skip drafts
-    return if front_matter['draft'] == true
+    if front_matter['draft'] == true
+      @stats['drafts'] += 1
+      return
+    else
+      @stats['published'] += 1
+    end
     
     # Count this content
     @stats['content_breakdown'][content_type] ||= 0
@@ -153,7 +210,10 @@ class SiteStatisticsGenerator
       end
     end
 
-    # Process dates for monthly distribution
+    # Process authors
+    analyze_authors(front_matter['author'])
+
+    # Process dates for monthly distribution and year tracking
     if front_matter['date']
       begin
         # Handle different date formats
@@ -169,12 +229,26 @@ class SiteStatisticsGenerator
         month_key = date.strftime('%Y-%m')
         @stats['monthly_distribution'][month_key] ||= 0
         @stats['monthly_distribution'][month_key] += 1
+        
+        # Track years
+        year = date.year.to_s
+        @stats['years'][year] ||= 0
+        @stats['years'][year] += 1
       rescue => e
         puts "⚠️  Date parsing error in #{file_path}: #{e.message} (date: #{front_matter['date']})"
         # Skip this date
       end
     end
 
+    # Analyze skill levels (from tags, categories, and content)
+    analyze_skill_levels(front_matter)
+    
+    # Analyze focus areas (from categories and tags)
+    analyze_focus_areas(front_matter)
+    
+    # Analyze content types (from layout, categories, or inferred)
+    analyze_content_types(front_matter)
+
     # Count words in content
     word_count = count_words(body_content)
     @stats['word_statistics'][File.basename(file_path)] = {
@@ -184,6 +258,86 @@ class SiteStatisticsGenerator
     }
   end
 
+  def analyze_authors(author)
+    return unless author.is_a?(String) && !author.strip.empty?
+    
+    clean_author = author.strip
+    @stats['authors'][clean_author] ||= 0
+    @stats['authors'][clean_author] += 1
+  end
+
+  def analyze_skill_levels(front_matter)
+    return unless @config['skill_levels']
+    
+    all_text = [
+      front_matter['title'],
+      front_matter['description'],
+      front_matter['categories'],
+      front_matter['tags']
+    ].flatten.compact.join(' ').downcase
+    
+    @config['skill_levels'].each do |level, indicators|
+      if indicators.any? { |indicator| all_text.include?(indicator) }
+        @stats['skill_levels'][level] ||= 0
+        @stats['skill_levels'][level] += 1
+      end
+    end
+  end
+
+  def analyze_focus_areas(front_matter)
+    return unless @config['focus_areas']
+    
+    all_text = [
+      front_matter['title'],
+      front_matter['description'],
+      front_matter['categories'],
+      front_matter['tags']
+    ].flatten.compact.join(' ').downcase
+    
+    @config['focus_areas'].each do |area, keywords|
+      if keywords.any? { |keyword| all_text.include?(keyword) }
+        @stats['focus_areas'][area] ||= 0
+        @stats['focus_areas'][area] += 1
+      end
+    end
+  end
+
+  def analyze_content_types(front_matter)
+    return unless @config['content_types']
+    
+    # Check layout first
+    layout = front_matter['layout']
+    if layout
+      case layout.downcase
+      when 'journals', 'journal', 'blog'
+        increment_content_type('Journal Entry')
+      when 'tutorial', 'guide'
+        increment_content_type('Tutorial')
+      when 'article'
+        increment_content_type('Article')
+      when 'documentation', 'docs'
+        increment_content_type('Documentation')
+      end
+    end
+    
+    # Check title and description
+    all_text = [
+      front_matter['title'],
+      front_matter['description']
+    ].compact.join(' ').downcase
+    
+    @config['content_types'].each do |type, keywords|
+      if keywords.any? { |keyword| all_text.include?(keyword) }
+        increment_content_type(type)
+      end
+    end
+  end
+
+  def increment_content_type(type)
+    @stats['content_types'][type] ||= 0
+    @stats['content_types'][type] += 1
+  end
+
   def count_words(content)
     # Remove markdown syntax and count words
     text = content.gsub(/[#*_`\[\](){}]/, ' ')  # Remove markdown syntax
@@ -208,19 +362,48 @@ class SiteStatisticsGenerator
       'total_content' => total_content,
       'total_categories' => @stats['categories'].keys.length,
       'total_tags' => @stats['tags'].keys.length,
+      'total_authors' => @stats['authors'].keys.length,
       'total_words' => total_words,
-      'average_words_per_post' => total_content > 0 ? (total_words.to_f / total_content).round(1) : 0
+      'average_words_per_post' => total_content > 0 ? (total_words.to_f / total_content).round(1) : 0,
+      'published' => @stats['published'],
+      'drafts' => @stats['drafts']
     }
   end
 
+  def calculate_derived_stats
+    # Calculate date range
+    years = @stats['years'].keys.map(&:to_i).sort
+    if years.any?
+      @stats['date_range'] = {
+        'earliest' => years.first,
+        'latest' => years.last,
+        'span_years' => years.last - years.first + 1
+      }
+    end
+    
+    # Calculate counts
+    @stats['category_count'] = @stats['categories'].length
+    @stats['tag_count'] = @stats['tags'].length
+    @stats['author_count'] = @stats['authors'].length
+  end
+
   def sort_and_finalize_data
     # Sort categories and tags by count (descending)
     @stats['categories'] = @stats['categories'].sort_by { |_, count| -count }.to_h
     @stats['tags'] = @stats['tags'].sort_by { |_, count| -count }.to_h
+    @stats['authors'] = @stats['authors'].sort_by { |_, count| -count }.to_h
+    @stats['focus_areas'] = @stats['focus_areas'].sort_by { |_, count| -count }.to_h
+    @stats['skill_levels'] = @stats['skill_levels'].sort_by { |_, count| -count }.to_h
+    @stats['content_types'] = @stats['content_types'].sort_by { |_, count| -count }.to_h
     
     # Sort monthly distribution by date
     @stats['monthly_distribution'] = @stats['monthly_distribution'].sort.to_h
     
+    # Create top lists
+    @stats['top_categories'] = @stats['categories'].first(5).to_h
+    @stats['top_tags'] = @stats['tags'].first(10).to_h
+    @stats['top_authors'] = @stats['authors'].first(5).to_h
+    
     # Convert to arrays for Jekyll (categories and tags)
     @stats['categories'] = @stats['categories'].map { |name, count| [name, count] }
     @stats['tags'] = @stats['tags'].map { |name, count| [name, count] }
@@ -242,25 +425,49 @@ class SiteStatisticsGenerator
     puts "📝 Total Posts: #{@stats['overview']['total_posts']}"
     puts "📄 Total Pages: #{@stats['overview']['total_pages']}"
     puts "📚 Total Content: #{@stats['overview']['total_content']}"
+    puts "✅ Published: #{@stats['overview']['published']}"
+    puts "📝 Drafts: #{@stats['overview']['drafts']}"
     puts "📂 Categories: #{@stats['overview']['total_categories']}"
     puts "🏷️  Tags: #{@stats['overview']['total_tags']}"
+    puts "👥 Authors: #{@stats['overview']['total_authors']}"
     puts "📝 Total Words: #{@stats['overview']['total_words'].to_s.reverse.gsub(/(\d{3})(?=\d)/, '\\1,').reverse}"
     puts "📊 Average Words/Post: #{@stats['overview']['average_words_per_post']}"
     
-    if @stats['categories'].any?
+    if @stats['date_range'].any?
+      puts "\n📅 DATE RANGE:"
+      puts "  Earliest: #{@stats['date_range']['earliest']}"
+      puts "  Latest: #{@stats['date_range']['latest']}"
+      puts "  Span: #{@stats['date_range']['span_years']} year(s)"
+    end
+    
+    if @stats['top_categories'].any?
       puts "\n🏆 TOP CATEGORIES:"
-      @stats['categories'].first(5).each_with_index do |(name, count), index|
+      @stats['top_categories'].each_with_index do |(name, count), index|
         puts "  #{index + 1}. #{name}: #{count} posts"
       end
     end
     
-    if @stats['tags'].any?
+    if @stats['top_tags'].any?
       puts "\n🏷️  TOP TAGS:"
-      @stats['tags'].first(10).each_with_index do |(name, count), index|
+      @stats['top_tags'].first(5).each_with_index do |(name, count), index|
         puts "  #{index + 1}. #{name}: #{count} uses"
       end
     end
     
+    if @stats['focus_areas'].any?
+      puts "\n🎯 FOCUS AREAS:"
+      @stats['focus_areas'].first(5).each_with_index do |(area, count), index|
+        puts "  #{index + 1}. #{area}: #{count} posts"
+      end
+    end
+    
+    if @stats['skill_levels'].any?
+      puts "\n📈 SKILL LEVELS:"
+      @stats['skill_levels'].each do |level, count|
+        puts "  #{level.capitalize}: #{count} posts"
+      end
+    end
+    
     puts "\n✅ Statistics generation complete!"
   end
 end

data/_data/generate_statistics.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+
+# Generate Content Statistics Script
+# Used by: Manual execution or CI/CD workflows
+# Purpose: Run the Ruby statistics generator with proper feedback
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+RUBY_SCRIPT="$SCRIPT_DIR/generate_statistics.rb"
+OUTPUT_FILE="$SCRIPT_DIR/content_statistics.yml"
+CONFIG_FILE="$SCRIPT_DIR/statistics_config.yml"
+
+echo -e "${BLUE}📊 Zer0-Mistakes Content Statistics Generator${NC}"
+echo "=================================================="
+
+# Check if Ruby is available
+if ! command -v ruby &> /dev/null; then
+    echo -e "${RED}❌ Error: Ruby is not installed or not in PATH${NC}"
+    echo "Please install Ruby to run the statistics generator."
+    exit 1
+fi
+
+echo -e "${GREEN}✅ Ruby found: $(ruby --version)${NC}"
+
+# Check if the Ruby script exists
+if [[ ! -f "$RUBY_SCRIPT" ]]; then
+    echo -e "${RED}❌ Error: Ruby script not found at $RUBY_SCRIPT${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✅ Statistics generator script found${NC}"
+
+# Check if config file exists
+if [[ -f "$CONFIG_FILE" ]]; then
+    echo -e "${GREEN}✅ Configuration file found: statistics_config.yml${NC}"
+else
+    echo -e "${YELLOW}⚠️  Configuration file not found, using defaults${NC}"
+fi
+
+# Check for content directories
+POSTS_DIR="$PROJECT_ROOT/pages/_posts"
+if [[ -d "$POSTS_DIR" ]]; then
+    POST_COUNT=$(find "$POSTS_DIR" -name "*.md" -type f | wc -l | tr -d ' ')
+    echo -e "${GREEN}✅ Found $POST_COUNT posts in pages/_posts${NC}"
+fi
+
+PAGES_DIR="$PROJECT_ROOT/pages"
+if [[ -d "$PAGES_DIR" ]]; then
+    PAGE_COUNT=$(find "$PAGES_DIR" -name "*.md" -type f ! -path "*/_posts/*" | wc -l | tr -d ' ')
+    echo -e "${GREEN}✅ Found $PAGE_COUNT pages in pages/${NC}"
+fi
+
+# Run the Ruby script from project root
+echo -e "${YELLOW}🔄 Generating statistics...${NC}"
+cd "$PROJECT_ROOT"
+if ruby "$RUBY_SCRIPT"; then
+    echo -e "${GREEN}✅ Statistics generated successfully!${NC}"
+else
+    echo -e "${RED}❌ Error: Failed to generate statistics${NC}"
+    exit 1
+fi
+
+# Check if output file was created
+if [[ -f "$OUTPUT_FILE" ]]; then
+    FILE_SIZE=$(du -h "$OUTPUT_FILE" | cut -f1)
+    echo -e "${GREEN}✅ Output file created: $OUTPUT_FILE ($FILE_SIZE)${NC}"
+    
+    # Show a preview of the generated statistics
+    echo -e "${BLUE}📋 Statistics Preview:${NC}"
+    echo "------------------------"
+    if command -v yq &> /dev/null; then
+        echo "Generated at: $(yq '.generated_at' "$OUTPUT_FILE")"
+        echo "Total Posts: $(yq '.overview.total_posts' "$OUTPUT_FILE")"
+        echo "Total Pages: $(yq '.overview.total_pages' "$OUTPUT_FILE")"
+        echo "Published: $(yq '.overview.published' "$OUTPUT_FILE")"
+        echo "Categories: $(yq '.overview.total_categories' "$OUTPUT_FILE")"
+        echo "Tags: $(yq '.overview.total_tags' "$OUTPUT_FILE")"
+    else
+        # Fallback to head if yq is not available
+        echo "Preview of generated data:"
+        head -25 "$OUTPUT_FILE"
+    fi
+else
+    echo -e "${RED}❌ Error: Output file was not created${NC}"
+    exit 1
+fi
+
+echo ""
+echo "=========================="
+echo -e "${GREEN}🎉 Content statistics generation complete!${NC}"
+echo ""
+echo "📝 The data is now available in _data/content_statistics.yml"
+echo "📊 Use the stats layout for display: layout: stats"
+echo ""
+echo "🔄 To regenerate statistics, run this script again:"
+echo "   bash _data/generate_statistics.sh"

data/_data/github-actions-example.yml

@@ -0,0 +1,210 @@
+# Example GitHub Actions workflow for automated content statistics
+# Save this as .github/workflows/update-statistics.yml
+#
+# This workflow automatically updates content_statistics.yml when:
+# - Posts or documentation content changes
+# - The statistics configuration is updated
+# - Manually triggered via workflow_dispatch
+# - Weekly scheduled run for maintenance
+#
+# For the Zer0-Mistakes Jekyll theme
+
+name: Update Content Statistics
+
+on:
+  # Run when content changes
+  push:
+    paths:
+      - 'pages/_posts/**'
+      - 'pages/_docs/**'
+      - 'pages/_quickstart/**'
+      - '_data/statistics_config.yml'
+    branches: [main]
+  
+  # Allow manual trigger with options
+  workflow_dispatch:
+    inputs:
+      force_update:
+        description: 'Force update even if no changes detected'
+        required: false
+        default: 'false'
+        type: boolean
+      skip_push:
+        description: 'Generate stats but do not commit/push'
+        required: false
+        default: 'false'
+        type: boolean
+  
+  # Run weekly to catch any missed updates
+  schedule:
+    - cron: '0 6 * * 1'  # Every Monday at 6 AM UTC
+
+env:
+  RUBY_VERSION: '3.2'
+  YQ_VERSION: 'v4.40.5'
+
+jobs:
+  update-statistics:
+    runs-on: ubuntu-latest
+    
+    permissions:
+      contents: write  # Allow the workflow to commit changes
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+      
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ env.RUBY_VERSION }}
+          bundler-cache: true
+      
+      - name: Install yq (for YAML processing)
+        run: |
+          sudo wget -qO /usr/local/bin/yq \
+            https://github.com/mikefarah/yq/releases/download/${{ env.YQ_VERSION }}/yq_linux_amd64
+          sudo chmod +x /usr/local/bin/yq
+          yq --version
+      
+      - name: Verify required files exist
+        run: |
+          echo "🔍 Checking required files..."
+          
+          if [ ! -f "_data/generate_statistics.rb" ]; then
+            echo "❌ Missing: _data/generate_statistics.rb"
+            exit 1
+          fi
+          
+          if [ ! -f "_data/update_statistics.sh" ]; then
+            echo "❌ Missing: _data/update_statistics.sh"
+            exit 1
+          fi
+          
+          echo "✅ All required files present"
+      
+      - name: Update content statistics
+        env:
+          CI: true
+          AUTO_PUSH: ${{ github.event.inputs.skip_push != 'true' }}
+          FORCE_UPDATE: ${{ github.event.inputs.force_update == 'true' }}
+        run: |
+          # Make scripts executable
+          chmod +x _data/update_statistics.sh
+          chmod +x _data/generate_statistics.sh 2>/dev/null || true
+          
+          # Run the update script
+          bash _data/update_statistics.sh
+      
+      - name: Display statistics summary
+        if: always()
+        run: |
+          if [ -f "_data/content_statistics.yml" ]; then
+            echo ""
+            echo "📊 Content Statistics Summary"
+            echo "════════════════════════════════════════════════════"
+            echo ""
+            
+            # Basic counts
+            echo "📝 Content Overview:"
+            echo "  Total Posts:  $(yq '.total_posts // 0' _data/content_statistics.yml)"
+            echo "  Published:    $(yq '.published // 0' _data/content_statistics.yml)"
+            echo "  Drafts:       $(yq '.drafts // 0' _data/content_statistics.yml)"
+            echo "  Categories:   $(yq '.category_count // 0' _data/content_statistics.yml)"
+            echo "  Tags:         $(yq '.tag_count // 0' _data/content_statistics.yml)"
+            echo ""
+            
+            # Focus areas if present
+            if yq -e '.focus_areas' _data/content_statistics.yml > /dev/null 2>&1; then
+              echo "🎯 Top Focus Areas:"
+              yq '.focus_areas | to_entries | sort_by(-.value) | .[0:5] | .[] | "  • " + .key + ": " + (.value | tostring)' \
+                _data/content_statistics.yml 2>/dev/null || echo "  (none)"
+              echo ""
+            fi
+            
+            # Skill levels if present
+            if yq -e '.skill_levels' _data/content_statistics.yml > /dev/null 2>&1; then
+              echo "📈 Skill Level Distribution:"
+              yq '.skill_levels | to_entries | .[] | "  • " + .key + ": " + (.value | tostring)' \
+                _data/content_statistics.yml 2>/dev/null || echo "  (none)"
+              echo ""
+            fi
+            
+            # Authors if present
+            if yq -e '.authors' _data/content_statistics.yml > /dev/null 2>&1; then
+              echo "✍️  Top Authors:"
+              yq '.authors | to_entries | sort_by(-.value) | .[0:3] | .[] | "  • " + .key + ": " + (.value | tostring) + " posts"' \
+                _data/content_statistics.yml 2>/dev/null || echo "  (none)"
+              echo ""
+            fi
+            
+            # Content freshness
+            if yq -e '.content_freshness' _data/content_statistics.yml > /dev/null 2>&1; then
+              echo "🕐 Content Freshness:"
+              yq '.content_freshness | to_entries | .[] | "  • " + .key + ": " + (.value | tostring)' \
+                _data/content_statistics.yml 2>/dev/null || echo "  (none)"
+              echo ""
+            fi
+            
+            # Derived stats
+            if yq -e '.derived_stats' _data/content_statistics.yml > /dev/null 2>&1; then
+              echo "📊 Derived Statistics:"
+              AVG_TAGS=$(yq '.derived_stats.avg_tags_per_post // "N/A"' _data/content_statistics.yml)
+              AVG_CATS=$(yq '.derived_stats.avg_categories_per_post // "N/A"' _data/content_statistics.yml)
+              TOP_CAT=$(yq '.derived_stats.most_common_category // "N/A"' _data/content_statistics.yml)
+              echo "  • Avg tags/post: ${AVG_TAGS}"
+              echo "  • Avg categories/post: ${AVG_CATS}"
+              echo "  • Most common category: ${TOP_CAT}"
+              echo ""
+            fi
+            
+            # Last updated
+            echo "🕒 Last Updated: $(yq '.generated_at // "unknown"' _data/content_statistics.yml)"
+            echo ""
+            echo "════════════════════════════════════════════════════"
+          else
+            echo "⚠️ Statistics file not found: _data/content_statistics.yml"
+          fi
+      
+      - name: Check for changes
+        id: changes
+        run: |
+          if git diff --quiet _data/content_statistics.yml; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Commit and push changes
+        if: steps.changes.outputs.has_changes == 'true' && github.event.inputs.skip_push != 'true'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          
+          git add _data/content_statistics.yml
+          git commit -m "chore(stats): update content statistics [skip ci]"
+          git push
+          
+          echo "✅ Statistics updated and pushed to repository"
+      
+      - name: Job summary
+        run: |
+          echo "## 📊 Content Statistics Update" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          if [ -f "_data/content_statistics.yml" ]; then
+            echo "| Metric | Value |" >> $GITHUB_STEP_SUMMARY
+            echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+            echo "| Total Posts | $(yq '.total_posts // 0' _data/content_statistics.yml) |" >> $GITHUB_STEP_SUMMARY
+            echo "| Published | $(yq '.published // 0' _data/content_statistics.yml) |" >> $GITHUB_STEP_SUMMARY
+            echo "| Drafts | $(yq '.drafts // 0' _data/content_statistics.yml) |" >> $GITHUB_STEP_SUMMARY
+            echo "| Categories | $(yq '.category_count // 0' _data/content_statistics.yml) |" >> $GITHUB_STEP_SUMMARY
+            echo "| Tags | $(yq '.tag_count // 0' _data/content_statistics.yml) |" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "_Last updated: $(yq '.generated_at // "unknown"' _data/content_statistics.yml)_" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "⚠️ Statistics file not generated" >> $GITHUB_STEP_SUMMARY
+          fi

data/_data/navigation/quickstart.yml

@@ -1,17 +1,25 @@
 # Quick Start Navigation Configuration
 # Used by: Quick Start sidebar and related pages
 # Purpose: Step-by-step guide navigation for new users
+# Order: Overview → Machine → Jekyll → GitHub → Personalization
 
 - title: "Quick Start"
   icon: bi-flag
   url: /quickstart/
   sublinks:
-    - title: "Machine Setup"
+    - title: "1. Machine Setup"
       url: /quickstart/machine-setup/
       icon: bi-laptop
-    - title: "Jekyll Setup"
+      description: "Install Docker, Git, and development tools"
+    - title: "2. Jekyll Setup"
       url: /quickstart/jekyll-setup/
       icon: bi-code-square
-    - title: "GitHub Setup"
+      description: "Configure Jekyll development environment"
+    - title: "3. GitHub Setup"
       url: /quickstart/github-setup/
       icon: bi-github
+      description: "Version control and deployment"
+    - title: "4. Personalization"
+      url: /quickstart/personalization/
+      icon: bi-palette
+      description: "Customize site identity and branding"