hexo各文件说明

基础配置

基础配置主要是设置网站的标题、描述、SEO、菜单等项，下面我就列出 hexo 的 config（根目录下_config.yml），和主题 Butterfly 的 config（themes 的 Butterfly 下_config.yml），并注释相关项的简介仅供参考。

hexo_butterfly_config.yml

hexo_butterfly_config.yml

创建文章

Page（页面）front-matter

站内搜索添加

站内搜索，我是采用的 hexo-generator-search 插件解决方案，安装完插件，然后配置一下，最后用 hexo 清理再生成一下全站静态，同时在根目录也会生成一个 search.xml，用于做字符串模糊匹配的。

插件安装

npm install hexo-generator-search --save

添加或配置

清理与生成以及部署

hexo clean && hexo g && hexo d

修改 Butterfly 配置

打开 butterfly 主题的配置文件，第一个找到 “gitalk” 项，将上面复制的 client id 和 client secrets 粘贴。
第二个找到 “comments”，将 use 配置为 “gitalk”，当然也可以用 valine、Disqus 之类的第三方评论系统。

文章置顶功能添加

打开 hexo 配置文件 _config.yml，如果前面有 per_page 的关闭，使用的是 hexo-generator-index 插件排序，可以自定义序号和日期排序。

如何要置顶文章，只需在文章 md 的 front-matter 里添加一个 top 参数，数值自定。文章列表会出现一个钉子图标，要看到效果则要 hexo 先清理再生成。

添加配置

md文章设置

设置 404 页面

在 hexo 的_config.yml 找到或添加 error_404，设置开启，分别添加标题和背景图。