abathur / sphinx

Main repository for the Sphinx documentation builder

Home Page:http://sphinx-doc.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Documentation Status https://travis-ci.org/sphinx-doc/sphinx.svg?branch=master

README for Sphinx

This is the Sphinx documentation generator, see http://www.sphinx-doc.org/.

Installing

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 .

Release signatures

Releases are signed with following keys:

Reading the docs

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.

Testing

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

Contributing

See CONTRIBUTING.rst

About

Main repository for the Sphinx documentation builder

http://sphinx-doc.org

License:Other


Languages

Language:Python 68.2%Language:JavaScript 28.7%Language:TeX 1.7%Language:HTML 0.8%Language:CSS 0.4%Language:Makefile 0.1%Language:C++ 0.0%Language:PHP 0.0%Language:Assembly 0.0%