This is the Sphinx documentation generator, see http://www.sphinx-doc.org/.
Install from PyPI to use stable version:
pip install -U sphinx
Install from PyPI to use beta version:
pip install -U --pre sphinx
Install from newest dev version in stable branch:
pip install git+https://github.com/sphinx-doc/sphinx@stable
Install from newest dev version in master branch:
pip install git+https://github.com/sphinx-doc/sphinx
Install from cloned source:
pip install .
Install from cloned source as editable:
pip install -e .
Releases are signed with following keys:
You can read them online at <http://www.sphinx-doc.org/>.
Or, after installing:
cd doc make html
Then, direct your browser to _build/html/index.html.
To run the tests with the interpreter available as python, use:
make test
If you want to use a different interpreter, e.g. python3, use:
PYTHON=python3 make test
Continuous testing runs on travis: https://travis-ci.org/sphinx-doc/sphinx
See CONTRIBUTING.rst