Hexo resources

Pipeline for Hexo.

• Hexo 4.x.x

Configuration

Add the following snippet in _config.yml.

Minimal config to enable filters for HTML, CSS, Js and images.

descco_pipeline:
  revisioning:
    enable: true
  node_sass:
    enable: true
  webpack:
    enable: true
  imagemin:
    enable: true
  html_minifier:
    enable: true
  jsonContent:
    enable: true

Components

Following are the modules that are being used to process differnet types of assets.

HTML (html_minifier)

html-minifier is used to minify the HTML files.

Following is the config for html-minifier.

Options

html_minifier:
  enable: true
  ignore_error: false
  exclude:

• enable - Enable the plugin. Defaults to false.
• ignore_error - Ignore the error occurred on parsing html
• exclude: Exclude files

html_minifier defaults

html_minifier
  ignoreCustomComments: [/^\s*more/]
  removeComments: true
  removeCommentsFromCDATA: true
  collapseWhitespace: true
  collapseBooleanAttributes: true
  removeEmptyAttributes: true
  minifyJS: true
  minifyCSS: true

Note: Check html-minifier for more options.

Images (imagemin)

imagemin is used to optimize images.

Following is the config for imagemin.

Options

imagemin:
  enable: true
  interlaced: false
  multipass: false
  optimizationLevel: 2
  pngquant: false
  progressive: false

• enable - Enable the plugin. Defaults to false.
• interlaced - Interlace gif for progressive rendering. Defaults to false.
• multipass - Optimize svg multiple times until it’s fully optimized. Defaults to false.
• optimizationLevel - Select an optimization level between 0 and 7. Defaults to 2.
• pngquant - Enable imagemin-pngquant plugin. Defaults to false.
• progressive - Lossless conversion to progressive. Defaults to false.
• exclude - Exclude specific types of image files, the input value could be gif,jpg, png, or svg. Default to null.

imagemin defaults

imagemin:
  interlaced: false
  multipass: false
  optimizationLevel: 3
  pngquant: false
  progressive: false

Note: Check imagemin for more options.

Revisioning

revisioning:
  enable: true
  keep: true
  exclude: ['robots.txt', '*.json']
  selectors:
    'img[data-orign]':  data-orign
    'img[data-src]': 'data-src'
    'img[src]': 'src'

• enable - Enable revisioning of assets. Defaults to false.
• keep - Keep original assets. Defaults to false.
• exclude - Exclude files from revisioning.
• selectors - It is used so that custom implementations can be processed. Any attribute matching the key should have the asset url in the value. For instance in above example any element matching to img[data-orign] will have the URL for asset in data-origin attribute, this specific case can be helpful for jquery lazyload implementations.

Revisioning defaults;

revisioning:
  enable: false
  keep: false
  exclude: []
  selectors:
    'img[data-src]': 'data-src'
    'img[src]': 'src'
    'link[rel="apple-touch-icon"]': 'href'
    'link[rel="icon"]': 'href'
    'link[rel="shortcut icon"]': 'href'
    'link[rel="stylesheet"]': 'href'
    'script[src]': 'src'
    'source[src]': 'src'
    'video[poster]': 'poster'

Note: To match paths in exclude option, glob matching is done using minmatch.

Observation

imagemin (Mac OS)

brew install libpng