实现方法

Hexo官方给出了两种插入自定义页面的方法:一是对指定文件进行渲染,形成在主题指定区域显示自定义页面;二是对相关文件或者文件夹进行忽略,完全进行不渲染,直接copypublic文件夹里进行链接。

1 部分渲染

实现原理

给单个文件添加不应用模板的标记,适用于个别特殊文件的处理。

实现方法

在不需要渲染的文章或HTML文件头部添加以下标记:

1
---layout: false---

这样,这个文件就不会经过模板渲染,最终发布到/public/里的文件就是去掉标记后的文件的样子。

2 排除文件

实现原理

只有source目录下的文件才会发布到public(能够在网络上访问到),因此Hexo只渲染source目录下的文件。skip_render参数设置的路径是相对于source目录的路径。

Hexo的配置文件中提供了配置项skip_render ,是用来对不需要的目录或者文件进行渲染排除。

  1. 排除单个文件

    1
    skip_render: 'test.html'
  2. 排除多个文件

    1
    2
    3
    skip_render:
    - '1.html'
    - '2.html'
  3. 正则表达式匹配

    1
    skip_render: '*.html'

    注意skip_render匹配的文件夹为source,这样会排除所有source文件夹下HTML结尾的文件,但是不会匹配到子目录。

  4. 排除目录

    1
    skip_render: 'demo/*'
  5. 排除多个目录

    1
    2
    3
    skip_render:
    - 'test/*'
    - 'demo/*'