"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.
我试过:
[conf.py] 我有行:
html_css_files = [
"css/yy.css",
]
所以我补充说:
app.add_css_file(html_css_files)
在 def setup(app):
但这导致了 readthedocs 中的构建错误
我在conf.py中添加了:
notfound_urls_prefix = "/projects/xxxxxx/en/latest/"
但这也没有帮助。
你遇到过类似的情况吗?如果有,您是如何解决问题的?
最终,根本原因在别处。
当我查看 rtd 上的原始输出时,我发现 sphinx_rtd_theme 安装了 0.4.3,这不是最新的。最新的是0.5.2。所以我将最新版本固定在 docs/requiremets.txt 中。这解决了搜索问题。
当我搜索 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.
我试过:
[conf.py] 我有行:
html_css_files = [ "css/yy.css", ]
所以我补充说:
app.add_css_file(html_css_files)
在 def setup(app):
但这导致了 readthedocs 中的构建错误
我在conf.py中添加了:
notfound_urls_prefix = "/projects/xxxxxx/en/latest/"
但这也没有帮助。
你遇到过类似的情况吗?如果有,您是如何解决问题的?
最终,根本原因在别处。 当我查看 rtd 上的原始输出时,我发现 sphinx_rtd_theme 安装了 0.4.3,这不是最新的。最新的是0.5.2。所以我将最新版本固定在 docs/requiremets.txt 中。这解决了搜索问题。