Source

sphinx /

Filename Size Date modified Message
doc
sphinx
tests
utils
268 B
2.0 KB
103 B
2.4 KB
58.6 KB
41.1 KB
10.2 KB
13.0 KB
586 B
1.6 KB
1.5 KB
151 B
574 B
11.6 KB
399 B
7.1 KB
360 B
378 B
353 B
364 B
652 B

README for Sphinx

Installing

Use setup.py:

python setup.py build
sudo python setup.py install

Reading the docs

After installing:

cd doc
sphinx-build . _build/html

Then, direct your browser to _build/html/index.html.

Or read them online at <http://sphinx-doc.org/>.

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

Contributing

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug. There are Non Assigned issues: https://bitbucket.org/birkenfeld/sphinx/issues?status=new&status=open&responsible=
  2. If you feel uncomfortable or uncertain about an issue or your changes, feel free to email sphinx-dev@googlegroups.com.
  3. Fork the repository on Bitbucket https://bitbucket.org/birkenfeld/sphinx to start making your changes to the default branch for next major version, or stable branch for next minor version.
  4. Write a test which shows that the bug was fixed or that the feature works as expected.
  5. Send a pull request and bug the maintainer until it gets merged and published. Make sure to add yourself to AUTHORS <https://bitbucket.org/birkenfeld/sphinx/src/tip/AUTHORS> and the change to CHANGES <https://bitbucket.org/birkenfeld/sphinx/src/tip/CHANGES>.