readthedocs - animeshtrivedi/notes GitHub Wiki

sudo apt-get install sphinx-rtd-theme-common
sudo apt-get install sphinx-common

if you run into

Running Sphinx v1.3.6
making output directory...

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

then install

sudo pip install sphinx==1.4.8

if after that pip is broken like this

Traceback (most recent call last):
  File "/usr/bin/pip", line 9, in <module>
    from pip import main
ImportError: cannot import name main

then see this: https://stackoverflow.com/questions/28210269/importerror-cannot-import-name-main-when-running-pip-version-command-in-windo

then update

sudo pip install --upgrade pip
⚠️ **GitHub.com Fallback** ⚠️