Hexo Next 主题中添加本地搜索功能

关于

随着时间的推移,个人站点的博客文章会越来越多,那怎么样才能快速找到你印象中的文章呢?增加一个站点内的搜索功能是非常有必要和方便的。

安装本地搜索插件 hexo-generator-search

在博客根目录下执行下列命令

1
npm install hexo-generator-search --save

安装之后,会在站点目录的 public 文件夹下创建一个 search.xml 文件。

修改全局配置文件_config.yml(博客根目录)

在站点配置文件 _config.yml 中添加如下内容:

1
2
3
4
5
6
# Search 
search:
path: ./public/search.xml
field: post
format: html
limit: 10000

path:索引文件的路径,相对于站点根目录
field:搜索范围,默认是 post,还可以选择 page、all,设置成 all 表示搜索所有页面
limit:限制搜索的条目数

hexo主题配置文件(/themes/next/_config.yml)

在主题配置文件 _config.yml 中找到如下内容:

1
2
3
4
local_search:
enable: true
trigger: auto
top_n_per_article: 1

修改local_searchenabletrue

top_n_per_article字段表示在每篇文章中显示的搜索结果数量,设成 -1 会显示每篇文章的所有搜索结果数量。

重新部署

然后执行以下命令,重新部署网站即可愉快的使用本地搜索功能了

1
hexo clean && hexo g && hexo d