hexo-lightning-minify v0.2.2

hexo-lightning-minify

Introduction

This plugin is a modular minifier extracted from hexo-renderer-multi-next-markdown-it. Refactored with modern minification tools (e.g., lightningcss), it achieves significant performance improvements compared to legacy implementations.

For comprehensive optimization solutions, consider using hexo-optimize. This project primarily serves as a companion package for ShokaX, focusing on essential minification and optimization functionalities.

Installation

pnpm add hexo-lightning-minify # Recommended with pnpm
npm install hexo-lightning-minify

Configuration

minify:
  js:
    enable: true # Not recommended for ShokaX (built-in esbuild optimization). Enable for other themes.
    exclude: # Excluded files (string[] compatible with micromatch patterns)
  css:
    enable: true # Enable CSS optimization
    options:
      targets: ">= 0.5%" # Browser targets in browserslist format
    exclude: # Excluded files (string[] compatible with micromatch patterns)
  image:
    enable: true # Enable image preprocessing and automatic WebP conversion
    options:
      # Format selection
      avif: true
      webp: false
      quality: 60 # Image quality (1-100 integer, lossless, or nearLossless)
      effort: 2 # CPU workload (0-6 integer, lower values prioritize speed)
      replaceSrc: true # Automatically replace local image URLs in HTML with optimized versions
      # Note: Service Worker implementation is recommended for less intrusive URL replacement
      enableSubSampling: true # Enable advanced chroma subsampling
      # For AVIF: Enables 4:2:0 subsampling (4:4:4 when disabled), optimizing size with minimal quality loss
      # For WebP: Allows extended CPU processing time for enhanced quality
      destroyOldRoute: false # Generate only processed images (preserve original assets)
      persistCache: true # Enable persistent caching of processed images
      # Stores optimized images on disk to accelerate subsequent builds
    exclude: # Excluded files (string[] compatible with micromatch patterns)

Features

• Automatic minification for JS, CSS, and HTML
• Automatic CSS prefix compatibility handling based on browser targets
• Automatic AVIF conversion and image preprocessing
• Preconnect optimization (long-term roadmap)

Benchmark

Note: Initial benchmark tests included HTML compression which has since been deprecated. Current results may vary.

Performance metrics from ShokaX v0.3.9: \

Testing framework using hexo-many-posts:

Environment: Hexo 6.3.0, minification limited to HTML/CSS/JS

hexo-theme-particlex excluded from visualization for clearer comparison