| 1 == Quick start == |
1 Quick start |
| |
2 =========== |
| 2 * Install Python 2.7 |
3 * Install Python 2.7 |
| 3 * Install setup tools : http://pypi.python.org/pypi/setuptools |
4 * Install setup tools : http://pypi.python.org/pypi/setuptools |
| 4 * Install sphinx by running |
5 * Install sphinx by running:: |
| 5 {{{ |
6 |
| 6 #!python |
7 easy_install Sphinx |
| 7 easy_install Sphinx |
8 |
| 8 }}} |
9 * Go into the documentation directory and run:: |
| 9 * Go into the documentation directory and run |
10 |
| 10 {{{ |
11 make html |
| 11 #!python |
12 |
| 12 make html |
|
| 13 }}} |
|
| 14 to generate an html version of the documentation or |
13 to generate an html version of the documentation or |
| 15 {{{ |
14 |
| 16 #!python |
15 make latexpdf |
| 17 make latexpdf |
16 |
| 18 }}} |
|
| 19 to generate a PDF document. |
17 to generate a PDF document. |
| 20 |
18 |
| 21 == Resources == |
19 Resources |
| |
20 ========= |
| 22 |
21 |
| 23 Sphinx main page: |
22 Sphinx main page: |
| |
23 |
| 24 http://sphinx.pocoo.org |
24 http://sphinx.pocoo.org |
| 25 |
25 |
| 26 Tutorial: |
26 Tutorial: |
| |
27 |
| 27 http://sphinx.pocoo.org/tutorial.html |
28 http://sphinx.pocoo.org/tutorial.html |
| 28 |
29 |
| 29 Restructured text: |
30 Restructured text: |
| |
31 |
| 30 http://sphinx.pocoo.org/rest.html |
32 http://sphinx.pocoo.org/rest.html |
| 31 |
33 |
| 32 Customising sphinx tutorial: |
34 Customising sphinx tutorial: |
| |
35 |
| 33 http://matplotlib.sourceforge.net/sampledoc/ |
36 http://matplotlib.sourceforge.net/sampledoc/ |
| 34 |
37 |