Hexo常见问题 - 主目录下添加.md文件或者.html文件

正如大家所知道的,当基于Hexo建站时,很多时候我们需要在部署文件的时候使用原始文件,但是在 hexo g 的命令之后,所有的 .md 或者 html 文件都会被 hexo 所渲染。这也就是所谓的,在 source文件夹 下的所有 md文件 都会被 hexo 渲染成 html文件,导致 .md文件 不能好好的放在里面了,即使是添加了 layout: false 依然没有用。

不过现在有相应的解决办法:

1. Hexo3.0 以下版本

利用主题的 source目录 ,也就是 themes/themes-name/source 。因为这个文件夹里面的所有文件都会被复制到网站的根目录中去,也就是说,如果在里面放上 .md 文件或者 html 文件,就可以正常的存在于网站的主目录了。

同样的,对于一些需要在网站下添加 html 文件的需求也可以这样来达成。比如百度或者谷歌在验证站长权限的时候,通常都会要求在主目录下添加一个 html 文件。同样的,只要把这个文件放在 themes/themes-name/source 就可以了。

2. Hexo3.0以上版本

使用 _config.yml 下的 skip_render 参数

skip_render 使用了 minimatch,开始匹配的位置是基于你的 source_dir 的,一般来说,是你的 source 文件夹下。

下面我分别列举几种常见的情况进行说明:

请注意 .yml 中的文件格式,输入单个数据请注意空格,输入数组请进行缩进!

  • 单个文件夹下全部文件:skip_render: test/*
  • 单个文件夹下指定类型文件:skip_render: test/xxx.md
  • 单个文件夹下全部文件以及子目录:skip_render: test/**
  • 多个文件夹以及各种复杂情况:
    skip_render:
    • test1/xxx.html
    • test2/xxx