blob: ae92a2ce35cd269b40c4df24e468b805094354d4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
=================
README for Sphinx
=================
This is the Sphinx documentation generator, see http://sphinx-doc.org/.
Installing
==========
Use ``setup.py``::
python setup.py build
sudo python setup.py install
Reading the docs
================
After installing::
cd doc
make 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
Continuous testing runs on drone.io:
.. image:: https://drone.io/bitbucket.org/birkenfeld/sphinx/status.png
:target: https://drone.io/bitbucket.org/birkenfeld/sphinx/
Contributing
============
#. 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=
#. If you feel uncomfortable or uncertain about an issue or your changes, feel
free to email sphinx-dev@googlegroups.com.
#. 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.
#. Write a test which shows that the bug was fixed or that the feature works
as expected.
#. 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>.
|