主题错误：找不到名为“furo”的主题（缺少 theme.conf？）

Question

我想先声明一下，我是 Sphinx 文档的初学者。 话虽这么说，我在尝试解决此问题时遇到了巨大的困难。 我正在尝试在我的项目中使用“furo”html 主题，但由于某种原因我无法这样做。

这是我到目前为止所做的尝试：

• 我已经使用

  pip install furo

  成功安装了furo。
• 我已经安装了 Sphinx 8.0.2，但由于某种原因，

  sphinx-build --version

  返回

  sphinx-build 5.0.2

• 我已更新

  html_theme

  中的

  conf.py

  选项以指向

  'furo'

另外，我也尝试过将

'furo'

添加到

extensions

中的

conf.py

中，但仍然出现标题中提到的主题错误。

Answer 1

一个好的做法是始终在虚拟环境中安装 python 包。它基本上可以防止包裹破裂（就您的情况而言）。这就是我要做的：

1. 导航到一个新目录，并在其中设置虚拟环境。这样做

python -m venv venv
.\venv\Scripts\activate

适用于 MacOS/Linux

python -m venv venv
source venv/bin/activate

2. 使用以下命令安装 Python 软件包：

   pip install sphinx

   和

   pip install furo

   。

3. 在我的

   conf.py

   文件中启用主题

html_theme = "furo"

对于迟回复表示歉意。