Hexo过滤器阶段

一、hexo g阶段

以下是 Hexo 中常用的过滤器阶段及其 执行顺序 的表格说明，按执行顺序排列：

阶段名称触发时机执行顺序描述
before_post_render在渲染文章（如 Markdown 转 HTML）之前触发最早用于修改文章内容的源文件，比如解析自定义标签或前置处理 Markdown 内容。
after_post_render在渲染文章后（HTML 已生成）触发较早用于处理文章渲染后的 HTML，比如添加自定义的 DOM 或属性。
before_generate在开始生成文件之前触发中间用于在文件生成前进行站点数据的修改或准备工作。
after_generate在所有文件生成完成后触发较晚用于修改生成后的文件或添加额外文件，通常用于 SEO 优化或缓存生成等后处理逻辑。
before_render在渲染文件之前触发依赖情况渲染所有类型文件（不仅限于文章，如模板、页面等）前触发，用于全局性修改。
after_render在渲染文件之后触发依赖情况渲染所有类型文件后触发，常用于压缩 HTML、CSS 或 JS 文件。
before_exit在 Hexo 进程结束之前触发最晚用于清理资源、保存缓存、写日志等退出前的操作。

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
/**
 * AnZhiYu
 * lazyload
 * replace src to data-lazy-src
 */

"use strict";

const urlFor = require("hexo-util").url_for.bind(hexo);

const lazyload = htmlContent => {
  const error_img = hexo.theme.config.error_img.post_page
  const bg = hexo.theme.config.lazyload.placeholder
    ? urlFor(hexo.theme.config.lazyload.placeholder)
    : "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7";
  return htmlContent.replace(
    /(<img(?!.class[\t]*=[\t]*['"].*?nolazyload.*?['"]).*? src=)/gi,
    `$1 "${bg}" data-lazy-src=`
  );
  //   return htmlContent.replace(
  //   /(<img(?!.class[\t]*=[\t]*['"].*?nolazyload.*?['"]).*? src=)/gi,
  //   `$1 "${bg}" onerror="this.onerror=null,this.src=&quot;${error_img}&quot;" data-lazy-src=`
  // );
}

hexo.extend.filter.register('after_render:html', data => {
  const { enable, field } = hexo.theme.config.lazyload
  if (!enable || field !== 'site') return
  return lazyload(data)
},1)

hexo.extend.filter.register('after_post_render', data => {
  const { enable, field } = hexo.theme.config.lazyload
  if (!enable || field !== 'post') return
  data.content = lazyload(data.content)
  return data
})

二、补充：

完整的 hexo.extend.filter.register 类别按执行顺序排列：

事件事件名称（hexo.extend.filter.register 类别）描述
初始化阶段before_init / after_init在Hexo初始化之前和之后触发，允许自定义项目结构和配置。
清理缓存阶段before_clean / after_clean在清理缓存之前和之后触发，用于在清理前后执行操作。
创建新文章new_post在创建新文章时触发，用于生成文章文件或执行额外的初始化操作。
生成阶段before_generate / after_generate在生成页面前后触发，允许修改或处理页面内容。
渲染页面阶段before_render / after_render在渲染页面内容之前和之后触发，允许修改渲染流程或渲染后的内容。
渲染HTML页面阶段after_render:html在HTML渲染完成后触发，用于修改或插入HTML结构，例如SEO优化等。
处理文章内容阶段before_post_render / after_post_render文章渲染前后触发，常用于插入文章的附加内容（如社交按钮等）。
内容处理阶段before_content_render / after_content_render用于文章内容的渲染前后，进行内容修改或格式化。
部署阶段before_deploy / after_deploy在部署之前和之后触发，用于自定义部署流程。
服务器启动阶段before_serve / after_serve在本地服务器启动前后触发，用于开发环境中的调试和优化。
发布后处理阶段after_publish在Hexo发布后触发，通常用于清理、日志记录或其他后期操作。