狮身人面像 Read-The-Docs 主题已识别但未“找到”

Sphinx Read-The-Docs Theme recognised but not "found"

提问人:glades 提问时间:9/16/2021 最后编辑:mzjnglades 更新时间:12/20/2022 访问量:13180

问:

我从 Github 下载了狮身人面像的 read-the-docs 主题,并将其放入 _themes 文件夹中。

conf.py:

html_theme = "sphinx_rtd_theme"
html_theme_path = ["_themes", ]

但是,运行“make html”时,我收到此错误:

Sphinx v4.1.2 in Verwendung
Lade Übersetzungen [de]…erledigt
loading pickled environment... erledigt
WARNING: sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0

Theme error:
no theme named 'sphinx_rtd_theme' found (missing theme.conf?)

不知何故,狮身人面像似乎找到了主题,然后无视它。有人可以告诉我发生了什么以及我该如何解决吗?

主题 python-sphinx read-the-docs

评论

1赞 mzjn 9/16/2021
我认为您应该使用“pip install sphinx-rtd-theme”(pypi.org/project/sphinx-rtd-theme 安装主题)
0赞 glades 9/16/2021
没错,它就起作用了。但是我还有另一个问题,即_templates文件夹中的模板不会通过“pip install sphinx-rtd-theme”在全局主题安装中触发
0赞 mzjn 9/16/2021
我不知道你说的“使用全局主题安装触发”是什么意思。
0赞 glades 9/16/2021
@mzjn对不起,解决了。我在错误的层次结构级别创建了_templates文件夹...回到最初的问题:那么通过 git repo 的方式是否不再受支持?
1赞 glades 9/16/2021
是的,显然,但它说它已被弃用(看底部)sphinx-rtd-theme.readthedocs.io/en/stable/installing.html

答:

19赞 Frederico Gago 3/31/2022 #1

需要安装:

pip install sphinx-rtd-theme

评论

0赞 Victor 3/31/2022
此文本可以作为评论而不是完整答案提供
2赞 Some Dev 6/8/2022
我确实已经安装,但仍然无法正常工作。sphinx-rtd-theme
0赞 Yasper 8/11/2022
@SomeDev 不知道这是否有帮助,但我在 M1 上并且遇到了同样的问题。它已安装,pip 在尝试安装它时抛出“已满足要求”。我通过注释掉 conf.py 文件中的“html_theme = ”sphinx_rtd_theme“”来解决这个问题。不确定影响是什么,但在那之后生成的 HTML 对我来说还不错。
9赞 Some Dev 6/8/2022 #2

我解决了!(与 OP 不同,因为他没有安装软件包,但也许它对某人有用)

如果它不适合您,请在文件中,因为包使用普通破折号。sure to use underscoresconf.py

在它应该是这样的,而不是这样的conf.pyhtml_theme = 'sphinx_rtd_theme'html_theme = 'sphinx-rtd-theme'

https://pypi.org/project/sphinx-rtd-theme/

0赞 mnb 12/15/2022 #3

我使用 Some Dev 提到的下划线点解决了它,但我还需要更新到最新版本:pip

python.exe -m pip install --upgrade pip

评论

0赞 Arthur Shlain 12/19/2022
请使用反引号换行命令文本 stackoverflow.com/editing-help#code-spans