建站|如何让Hexo不渲染部分markdown文件

本文最后更新于 2024年3月27日 下午

默认情况下,Hexo会渲染所有的HTML和Markdown文件。在source文件夹下的所有开头不是下划线的文件,在hexo generate的时候,都会被拷贝到public文件夹下。

如果在Hexo建站过程中,如何让Hexo不渲染部分markdown文件呢?

这时候需要使用skip_render配置。

根据Hexo文档中的说明,通过在_config.yml配置文件中使用skip_render参数,可以跳过指定文件的渲染。路径匹配可以使用正则表达式。

使用方式如下:

skip_render: [file/**, img/**]

注意:skip_render参数设置的路径是相对于source目录的路径。例如,需要跳过渲染source/README.md,只需要设置 skip_render:README.md

在设置了跳过渲染之后,最好使用hexo clean清除以前的编译结果,保证配置生效。

如果本来有一个HTML文件的话,可以简单地在文件开头加上layout: false一行。

1
2
3
4
5
layout: false
---

<html>
...