当页面上不存在该短语时，“搜索...”需要永远阅读文档

Question

当我搜索 readthedocs 页面上不存在的短语时，我收到消息：

“搜索...”，这将花费很长时间。相反，当我搜索一些已知的短语时，我会在一秒钟内得到结果。

我查看了页面的控制台：

来自“https://xxxxxx.readthedocs.io/en/latest/_static/css/yy.css”的资源由于 MIME 类型（“text/html”）不匹配而被阻止（X-Content-Type-Options：不闻）。 阅读文档搜索失败。回到狮身人面像搜索。

我已经尝试过：

1. [conf.py] 我有一行：

   html_css_files = [
       "css/yy.css",
   ]
   

所以我补充道：

app.add_css_file(html_css_files)

在

def setup(app):

但这导致了 readthedocs 中的构建错误

2. 我已经在conf.py中添加了：

   notfound_urls_prefix = "/projects/xxxxxx/en/latest/"
   

但这也没有帮助。

你遇到过类似的事情吗？如果是这样，你是如何解决这个问题的？

Answer 1

最终，根本原因在其他地方。 当我查看 rtd 上的原始输出时，我发现 sphinx_rtd_theme 是随 0.4.3 安装的，这不是最新的。最新的是0.5.2。所以我将最新版本固定在我的 docs/requiremets.txt 中。这解决了搜索问题。

Answer 2

我遇到了同样的问题。我通过删除

conf.py

文件中的这一行来修复它：

html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

这样做之后，重建文档，问题就解决了。