自 1.4.0 版本以来，sphinx_rtd_theme 不再是硬依赖项

Question

C:\Users\Administrator\Desktop\item\code_serv\documents\api>make html 运行 Sphinx v1.6.2 加载 pickled 环境...失败：

无法获取属性“WarningStream”<module 'sphinx.util.nodes' from 'c:\\users\\administrator\\appdata\\local\\programs\\python\\python36-32\\lib\\site-packages\\sphinx\\util\\nodes.py'>

主题错误：

sphinx_rtd_theme 不再是硬依赖项，因为version 1.4.0. 请手动安装。( pip install sphinx_rtd_theme)

我该如何解决这个问题？

Answer 1

我发现了另一个问题，我安装了两套 sphinx，一套是 via pip，另一套是 via brew。删除一个（我选择删除通过 完成的安装brew）解决了这个问题。

brew remove sphinx-doc

如果还是不行，请尝试卸载并重新安装

pip3  uninstall sphinx sphinx_rtd_theme
pip3  install sphinx sphinx_rtd_theme

Answer 2

就我而言（从RTD 主题源html_theme_path构建），问题似乎是由配置值的行为变化引起的conf.py. 虽然过去接受相对于 makefile 目录的路径，但现在路径必须相对于配置目录：

\n\n

\n

html_主题_路径

\n\n

包含自定义主题的路径列表，可以是子目录或 zip 文件。相对路径被视为相对于配置目录。

\n\n

0.6版本中的新功能。

\n\n

\xe2\x80\x94 Sphinx 文档 > 配置

\n

\n