安装本地搜索

在 Hexo 中安装本地搜索功能可以通过安装插件来实现,这样用户可以离线使用搜索功能,提升访问体验。以下是详细步骤:

  1. 安装 hexo-generator-searchdb 插件
    hexo-generator-searchdb 是一个常用的插件,它会在生成站点时创建一个 JSON 数据库文件,供前端搜索使用。

运行以下命令安装插件:

bash
复制代码
npm install hexo-generator-searchdb –save
2. 配置 _config.yml
在 Hexo 主配置文件 _config.yml 中添加 hexo-generator-searchdb 的配置:

yaml
复制代码
search:
path: search.json # 生成的搜索数据库文件路径
field: post # 搜索范围,可以是 post、page 或 both
format: html # 数据格式,可选 html 或 excerpt
limit: 10000 # 搜索结果的最大数量
field: post 表示仅对文章进行搜索。如果你想让页面也能被搜索,可以改成 both。
format: html 表示保存完整的 HTML 格式内容,excerpt 表示保存简略文本。
3. 修改主题配置文件
根据你使用的主题(例如 AnZhiYu),确保主题支持本地搜索功能,通常只需要在主题配置文件中启用本地搜索即可。

在 anzhiyu/_config.yml 中找到并启用搜索功能:

yaml
复制代码
local_search:
enable: true
如果主题未集成本地搜索,可以手动添加相关脚本。

  1. 引入前端脚本
    确保模板中引用了本地搜索的前端脚本。如果你的主题未集成,可以使用以下示例脚本(以 AnZhiYu 主题为例):

html
复制代码

你也可以使用第三方库,例如 Simple-Jekyll-Search 来处理前端搜索功能。

  1. 重新生成站点
    完成配置后,重新生成站点并启动本地服务:

bash
复制代码
hexo clean && hexo g && hexo s
然后在浏览器中打开站点并测试搜索功能。