mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2026-10-12 08:25:01 -05:00
1639f5972688dda9a90c7fcea5780d5718d52967
This option is equivalent to the includehidden option of the template function toctree() and allows to restore to the toctree behaviour prior to version 1.1. See also bug #790.
=================
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
============
Send wishes, comments, patches, etc. to sphinx-dev@googlegroups.com.
Languages
Python
72.6%
JavaScript
18.9%
TeX
5.5%
Jinja
2.2%
HTML
0.5%
Other
0.2%