Skip to content

给 VitePress 添加 algolia 搜索解决方案(高版本 alpha.37 以后)

作者:Richard-Zhang1019
发表于:2023-02-17
更新于:7 个月前
字数统计:433 字
阅读时长:1 分钟

按照之前的方案在使用 alpha.36 之前的版本是没问题的,但是由于 alpha.37 开始支持 i18n,原来的方法似乎不奏效了,在控制台 network 里发现没有返回搜索结果,这好我自己也在做文档搜索相关的内容,就去调研了一下,得到了一个非常简单的解决方案。

首先我是去 vitepress 下提了一个 issue

algolia Search can’t return result · Issue #1935 · vuejs/vitepress
https://github.com/vuejs/vitepress/issues/1935

很快给我了回复,但是他是认为是我这边的爬虫问题,让我去 algolia 控制台重启爬虫,这也并没有解决,也就不不了了之了。

隔了几天另一位朋友在我的 issue 下留言,提供了他的爬虫配置,在爬虫文件里加了些配置,我立马去在我自己的项目里去尝试了下,没想到直接就成功了,立马过来文档里来分享给各位。

我自己的 vitepress 是使用的目前最新的 vitepress 1.0.0-alpha.45,这个方法是没问题的,并且很简单,只需要在爬虫里加一些字段即可。

json
{
  "index_name": "***",
  "start_urls": ["***"],
  "rateLimit": 8,
  "maxDepth": 10,
  "selectors": {
    "lvl0": {
      "selector": "",
      "defaultValue": "Documentation"
    },
    "lvl1": ".content h1",
    "lvl2": ".content h2",
    "lvl3": ".content h3",
    "lvl4": ".content h4",
    "lvl5": ".content h5",
    "content": ".content p, .content li",
    "lang": {
      "selector": "/html/@lang",
      "type": "xpath",
      "global": true
    }
  },
  "selectors_exclude": [
    "aside",
    ".page-footer",
    ".next-and-prev-link",
    ".table-of-contents"
  ],
  "custom_settings": {
    "attributesForFaceting": ["lang", "tags"]
  },
  "js_render": true
}

这里是我自己的网站使用的搜索,大家可以去试一下。

lucky-design
https://lucky-design.vercel.app/

Contributors

Richard-Zhang1019
Choi Yang