步骤 1：配置搜索功能

从butterfly的_config.yml文件中到找search

在 search 设置中，选择使用本地搜索（local_search）或使用 Algolia 搜索（algolia_search）。如果你想使用本地搜索，可以按照以下步骤配置：

  1. 启用本地搜索
    在 search 配置块下，设置 use: local_search，并确保 local_search 的配置项被正确设置。
1
2
3
4
5
6
7
8
9
10
search:
  use: local_search
  placeholder: "搜索文章..."  # 你可以自定义搜索框的占位符
  local_search:
    preload: true  # 页面加载时预加载搜索数据
    top_n_per_article: 1  # 每篇文章显示前 n 个搜索结果
    unescape: false  # 将 HTML 字符串转义为可读形式
    pagination:
      enable: false  # 不启用搜索结果分页
      hitsPerPage: 8  # 每页显示 8 个搜索结果
  1. 如果你选择使用 Algolia 搜索，你需要配置相应的 Algolia 搜索 API 配置：
1
2
3
4
5
6
7
8
search:
  use: algolia_search
  placeholder: "搜索文章..."
  algolia_search:
    appId: "你的 appId"
    apiKey: "你的 apiKey"
    indexName: "你的 indexName"
    hitsPerPage: 6  # 每页显示搜索结果的数量

步骤 2：安装依赖插件

如果你使用的是 local_search，需要安装 hexo-generator-search 插件，它会生成用于搜索的索引文件。在 Hexo 项目的根目录下运行以下命令安装该插件：

1
npm install hexo-generator-search --save

步骤 3：生成并部署

配置完成后，执行 Hexo 的 generate 命令生成静态文件，并通过 deploy 命令将其部署到你的博客站点。

1
hexo cl && hexo g && hexo d