狮身人面像搜索索引警告

时间:2013-08-12 14:26:29

标签: python python-sphinx

我在Sphinx中收到此警告:

  

警告:无法加载搜索索引,但并非所有文档都会加载   建立:索引将不完整。

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

该错误消息实际上意味着什么以及如何解决它?

回答注意:当前的调用是sphinx-build -W -n docs/ docs/html *.rst

1 个答案:

答案 0 :(得分:4)

错误消息来自此处:

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

我的猜测是你的搜索索引 实际上是不完整的,但不是很明显。如果使用-E构建所有文档,则可能会获得更有用的内容。除此之外,尝试构建一个新的输出目录;错误可能是因为当前索引文件的权限不正确。

潜在的问题是,不知何故,索引器无法加载以前生成的文件,并且没有重建整个doctree,因此期望它不会重建的文件不会出现在搜索索引完成后。尝试使用-E和-W的各种组合(实际上,您当前的sphinx调用cmdline会有所帮助),希望能够获得更具描述性的内容。