local versions of sphinx wikis #python #blender

Blender Python Local API

# install sphinx
sudo apt-get install python-setuptools
# add a sudo if the following didn't work
easy_install -U sphinx

# use sphinx to export the HTMLs (we need blender source for that)
mkdir ./doc/python_api/sphinx-out
sphinx-build ./doc/python_api/sphinx-in ./doc/python_api/sphinx-out

# use sphinx to export the LATEXs, this one didn't output a working pdf for me!
sphinx-build -n -b latex ./doc/python_api/sphinx-in ./doc/python_api/sphinx-out2

# use sphinx to export the PDFs, this one halted and didn't continue!
sudo apt-get install rst2pdf
# register rst2pdf in the ./doc/python_api/sphinx-in/conf.py Sphinx config
extensions = ['sphinx.ext.autodoc','rst2pdf.pdfbuilder']
sphinx-build -bpdf latex ./doc/python_api/sphinx-in ./doc/python_api/sphinx-out2