Registry / devops / hexo-filter-cleanup

hexo-filter-cleanup

library1.2.2jsnpmunverified

A Hexo plugin that bundles HTML, CSS, JS minification, image optimization, HTML useref, and favicon generation into a single filter. Version 1.2.2, last updated in 2019. It replaces the older hexo-all-minifier with fixes for submodule bugs and adds useref support. Key differentiator: all-in-one cleanup for Hexo sites with configurable options for each asset type. No longer actively maintained; users may prefer individual hexo minifier plugins or newer alternatives.

devops

npm install hexo-filter-cleanup

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · HEXO-FILTER-CLEANU

hexo-filter-cleanup

devopsjavascriptv1.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

hexo-filter-cleanup

✓ npm install hexo-filter-cleanup --save

✗ npm install hexo-filter-cleanup --save-dev

Must be installed as a runtime dependency to run as a Hexo plugin.

Shows basic installation and configuration of the plugin with all minification features enabled.

// Install the plugin npm install hexo-filter-cleanup --save // In _config.yml, add configuration: hfc_html: enable: true hfc_css: enable: true exclude: - '*.min.css' hfc_js: enable: true mangle: true hfc_img: enable: true hfc_useref: enable: true concat: true hfc_favicons: enable: false

Debug

Known issues

gotchaPlugin is no longer actively maintained; last commit in 2019. May have compatibility issues with newer Hexo versions (>5.0).

fix

Consider using individual hexo minifier plugins (hexo-html-minifier, hexo-clean-css, hexo-uglify, hexo-imagemin) or switch to hexo-all-minifier if it resolves issues.

affects: >=1.0

gotchaThe favicons feature (hfc_favicons) may not work out of the box due to node version incompatibilities with the favicons package.

fix

Disable favicon generation (enable: false) or test with Node 10/12.

affects: >=1.0

breakingThe plugin overrides default Hexo minifier filter order; may conflict with other minifier plugins if both are enabled.

fix

Disable other minifier plugins when using hexo-filter-cleanup to avoid duplication.

affects: >=1.0

Errors

Common errors & fixes

ERROR Process failed: TypeError: Cannot read property 'replace' of undefined

Likely due to missing configuration for a feature (e.g., favicons src not set).

fix

Set hfc_favicons.enable: false or provide a valid hfc_favicons.src path.

FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html TypeError: hexo is not a constructor

Incompatible with Hexo 5+ due to breaking changes in Hexo's filter system.

fix

Downgrade Hexo to 4.x or switch to alternative minifier plugins.

Upgrade

Version history

1.2.2latest on npm

Audit

Dependencies

hexorequiredPeer dependency; plugin runs as a Hexo filter

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/mamboer/hexo-filter-cleanup ↗

packagehexo-filter-cleanup ↗

homepagehttps://github.com/mamboer/hexo-filter-cleanup#readme ↗