search

cheese-hub / cheesehub

CHEESE project website and documentation
2 stars 4 forks source link

Contributor's guide #7

Closed craig-willis closed 6 years ago

craig-willis commented 6 years ago
bodom0015 commented 6 years ago

I am unable to run the Sphinx docgen process... there seem to be some missing dependencies here.

ubuntu@lambert8-dev:~/cheesehub/docs$ pip install -r requirements.txt 
Requirement already satisfied: sphinx in /usr/lib/python3/dist-packages (from -r requirements.txt (line 1)) (1.3.6)
Requirement already satisfied: sphinx_bootstrap_theme in /home/ubuntu/.local/lib/python3.5/site-packages (from -r requirements.txt (line 2)) (0.6.5)
Requirement already satisfied: six>=1.4 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (1.10.0)
Requirement already satisfied: Jinja2>=2.3 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (2.8)
Requirement already satisfied: Pygments>=2.0 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (2.1)
Requirement already satisfied: docutils>=0.11 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (0.12)
Requirement already satisfied: babel!=2.0,>=1.3 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (1.3)
Requirement already satisfied: alabaster<0.8,>=0.7 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (0.7.7)
Requirement already satisfied: sphinx_rtd_theme<2.0,>=0.1 in /usr/lib/python3/dist-packages (from sphinx->-r requirements.txt (line 1)) (0.1.9)
Requirement already satisfied: setuptools in /home/ubuntu/.local/lib/python3.5/site-packages (from sphinx_bootstrap_theme->-r requirements.txt (line 2)) (40.0.0)
Requirement already satisfied: MarkupSafe in /usr/lib/python3/dist-packages (from Jinja2>=2.3->sphinx->-r requirements.txt (line 1)) (0.23)
Requirement already satisfied: pytz>=0a in /usr/lib/python3/dist-packages (from babel!=2.0,>=1.3->sphinx->-r requirements.txt (line 1)) (2014.10)
ubuntu@lambert8-dev:~/cheesehub/docs$ make html
Running Sphinx v1.3.6

Extension error:
Could not import extension sphinx.ext.githubpages (exception: No module named 'sphinx.ext.githubpages')
Makefile:20: recipe for target 'html' failed
make: *** [html] Error 1

This is possibly addressed in version 1.4 of Sphinx: https://github.com/rtfd/readthedocs.org/issues/2269