python - 尝试构建 CKAN 的文档时出现错误消息“没有名为 'sphinx-theme-okfn' 的主题”

Question

我在 virtualenv 中安装了 CKAN 并激活了 virtualenv，并且我已经在 pip-requirements-docs.txt 中安装了要求，但是当我尝试构建文档时出现此错误：

> python setup.py build_sphinx
...
sphinx.errors.ThemeError: no theme named 'sphinx-theme-okfn' found (missing theme.conf?)

Answer 1

问题是 CKAN 使用的 Sphinx 主题不是 CKAN git 存储库本身的一部分，它有自己的 git 存储库，它是 CKAN git 存储库的子模块。因此，在构建文档之前，您需要检查子模块：

> git submodule init
> git submodule update
> python setup.py build_sphinx

Answer 2

我多次尝试上述解决方案。我什至升级了 Babel 和 Pygments 并再次尝试 - 无济于事。一直都是同样的错误。最后，我将一个名为 theme.conf 的文件从https://github.com/rostock/opendata.hro/tree/master/ckan/doc/_themes/sphinx-theme-okfn复制到目录 ~/ckan/default/src/ckan /doc/_themes/sphinx-theme-okfn; 因此我能够以某种方式运行 sphinx 并在 Windows 上为我的 CKAN 1.8 生成可读的文档。也许我的解决方法会对某人有用？