"Searching..." 当页面上不存在该短语时,readthedocs 将永远占用

"Searching..." takes forever on readthedocs when the phrase is not present on the page

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

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

我查看了页面的控制台:

The resource from “https://xxxxxx.readthedocs.io/en/latest/_static/css/yy.css” was blocked due to MIME type (“text/html”) mismatch (X-Content-Type-Options: nosniff). Read the Docs search failed. Falling back to Sphinx search.

我试过:

  1. [conf.py] 我有行:

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

所以我补充说:

app.add_css_file(html_css_files)def setup(app):

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

  1. 我在conf.py中添加了:

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

但这也没有帮助。

你遇到过类似的情况吗?如果有,您是如何解决问题的?

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