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 repo，它是CKAN git repo的submodule。因此，在构建文档之前，您需要签出子模块：

> 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并为我的CKAN 1.8在Windows上生成可读的文档。也许我的解决方法会对某人有用吗？

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

2 个答案: