I have CKAN installed in a virtualenv and the virtualenv activated, and I’ve installed the requirements in pip-requirements-docs.txt, but when I try to build the docs I get this error:
> python setup.py build_sphinx
...
sphinx.errors.ThemeError: no theme named 'sphinx-theme-okfn' found (missing theme.conf?)
The problem is that the Sphinx theme that CKAN uses is not part of the CKAN git repository itself, it has its own git repo which is a submodule of the CKAN git repo. So before you can build the docs, you need to checkout the submodule: