To build the webpages (run from docs/):

   make html


To automatically generate the API docs (run from repository root):

   sphinx-apidoc -l -f -M -o docs/source/ pyro/

  (-M puts the module before submodule in the API pages; any files/directories after pyro/ are excludes)


To support notebooks:

pip3 install nbsphinx --user
dnf install pandoc
dnf install python3-ipython-sphinx

For numpy doc format:

pip3 install numpydoc --user


For the theme:

pip install sphinx_rtd_theme



Youtube:

https://bitbucket.org/birkenfeld/sphinx-contrib/src/49a8e96bc8a7/youtube/

https://github.com/rtfd/readthedocs.org/issues/879

button:

https://github.com/conda/conda-docs/blob/master/web/button.py
https://stackoverflow.com/questions/25088113/make-a-css-button-a-link-in-sphinx
https://buttons.github.io/

http://docs.readthedocs.io/en/latest/guides/adding-custom-css.html
