python - 狮身人面像搜索索引警告

Question

我在 Sphinx 中收到此警告：

警告：无法加载搜索索引，但不会构建所有文档：索引将不完整。

但据我所知，它构建的文档很好，包括搜索索引。

该错误消息的实际含义是什么以及如何修复它？

答案中的注释：当前调用是sphinx-build -W -n docs/ docs/html *.rst.

Answer 1

错误消息来自这里：

https://bitbucket.org/birkenfeld/sphinx/src/ef3092d458cc00c4b74dd342ea05ba1059a5da70/sphinx/builders/html.py?at=default#cl-664

我的猜测是您的搜索索引实际上是不完整的，但不是以明显的方式。如果您使用 构建所有文档-E，您可能会得到更有用的东西。除此之外，尝试构建到一个新的输出目录；该错误可能是由于您当前索引文件的权限不正确。

根本问题是，不知何故，索引器无法加载先前生成的文件，并且没有重建整个文档树，因此预计它没有重建的文件不会出现在搜索索引中完成。尝试各种 -E 和 -W 组合（实际上，您当前的 sphinx 调用 cmdline 会有所帮助）以希望获得更具描述性的内容。