尝试构建CKAN文档时出现错误消息“没有名为‘sphinxthemeokfn’的主题”

Question

我在virtualenv中安装了CKAN并激活了virtualenv，并且在pip requirements中安装了需求-文档.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