引言

在Hexo中如果需要自定义一些自己喜欢的主题或者页面,hexo默认会编译source目录下的所有文件。

下面主要给大家分享一个实用的技术点:自定义无需编译的文件。

操作方法

修改_config.yml中一个配置项skip_render

官网说明如下:
skip_render:跳过指定文件的渲染,您可使用glob表达式来匹配路径。

配置示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 跳过单个文件
skip_render: test.html

# 跳过所有的html的文件
skip_render: '*.html'

# 跳过某一目录下的所有文件:
skip_render: test/*

# 需要跳过某一目录下的所有文件和子目录时:
skip_render: test/**

# 跳过多个目录,或者多个文件:
skip_render: ['*.html', demo/**, test/*]

# 也可以配置成多行
skip_render:
- test1/*.html
- test2/**

注意事项

  1. 如果设置skip_render不起作用,可以先执行hexo clean清除一下缓存。
  2. 如果跳过多个目录编译失败,请尝试更新hexo, 在source同级目录中执行npm update hexo
  3. 如果需要查看是否成功跳过编译,可以在编译的时候加上--debug,例如:hexo generate --debug,关注打印出来的Rendering xxxx中的东西。