Repository navigation
sphinx dependency not met, cannot be installed via method provided #4
Description
From https://github.com/AMDphreak/doc-developer-guide
ryan@ryan-ADATA:~/code/online/doc-developer-guide/docs$ make html
Running Sphinx v1.6.7
loading pickled environment... not yet created
Theme error:
sphinx_rtd_theme is no longer a hard dependency since version 1.4.0. Please install it manually.(pip install sphinx_rtd_theme)
Makefile:20: recipe for target 'html' failed
make: *** [html] Error 1
It does not tell me which version of python this make is using, so I installed sphinx_rtd_theme on both python 2.7.x and 3.x via pip and pip3. This resolved nothing.
No work-around available (afaik)
Activity
AMDphreak commentedon Jan 30, 2020
The tutorial says to install sphinx without specifying a version of python and a version of sphinx. Installing with latest library invalidates the rtd theme. I have tested and successfully generated an HTML using the up to date sphinx library that uses the new theme. I will submit a PR. Please review my solution. The new theme doesn't have the green code blocks (which I think was intentionally selected for Mint). At the very least, the new docs will generate properly for developers.
Odyseus commentedon Jan 30, 2020
Hello, @AMDphreak.
A couple of observations.
python-sphinxpackage (which is the Python 2 implementation of Sphinx). I think that it should instruct to install thepython3-sphinxpackage.python3-sphinx-rtd-themepackage. I think that this documentation was initially written around Linux Mint 18.x. At that time thepython3-sphinx-rtd-themepackage was a dependency of thepython3-sphinxpackage.pip. The use of a Python module installed from the repositories that depends on a Python module installed frompipis a recipe for disaster.python-sphinxpackage (the Python 2 implementation) might or might not be available in Ubuntu 20.04 in which Linux Mint 20 will be based.