跳到主要内容

缺陷

Algolia

信息

2024 年底,我被 Algolia 频繁失败、遗漏折磨疯了,卸载了 Algolia,决定改用 @easyops-cn/docusaurus-search-local
由于暂无空闲时间,新引擎预计会在 2025 下半年上线。
因此,以下内容都已是过去式。但如果您能指出,仍将有益。

索引延迟

  本站右上角(Ctrl + K)搜索功能并不是在网页文件当中检索文本,而是用 Algolia 的免费 crawler 功能生成索引。Algolia 用他们的服务器访问本站,索引一遍,本站再访问他们的 API 接口,拿回最新索引。本来这顺理成章地可以「部署触发」,也就是在我每次上传改动或新内容到源代码库时自动生成新索引。然而 Docusaurus 唯一能完美支持的 Algolia 方式是在 JavaScript 语句中写密钥,而这个免费密钥又是用电子邮件发送附带网址信息的申请得到的。这种方式在 Algolia 的产品线中相对独立,无法与托管站点的服务器形成工作流协同。
  因此,我只能设定每天固定时间生成一次索引,间隔 24 小时。

  所以,如果你发现某些文字内容是存在的,但在搜索框搜不到,请勿惊慌,说明这些文本上传还不到 24 小时,明天你就能搜到了。

Markdown 链接对 Algolia 搜索功能的支持缺陷

  受本人技术水平限制(也有可能是受此 Docusaurus 开发者的产品设计水平限制),此网站使用 Markdown 文件编辑内容的网页当中,使用 Markdown 扩展语法形成的网页链接,无论是文字内容,还是链接地址,在搜索框中均无法显示为搜索结果。
例如:  

xxx.md
xxx  
[入口](https://notes.pengxianzhe.org)
xxx

显示效果:

xxx
入口
xxx

  在搜索框搜索「xxx」会显示两个结果,但无论搜索「域名主页」还是「https://notes.pengxianzhe.org」都不会显示任何结果。
  如果您知道问题的成因和解决方式,欢迎在源代码库指出。