[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

[Pulp-list] Sphinx resources

I know the idea of using Sphinx for documentation is being kicked around, so I figured I'd offer some additional pointers to resources:

Sphinx's own tutorial:

The RTFD (hosting site for Sphinx docs) getting started guide:

The ReStructured Text primer from the Python docs*:

And the Sphinx specific additions (many of these are from Sphinx itself, a few are CPython specific additions):

*As mentioned on the site, the Sphinx project actually started when Georg wrote it to replace the dodgy old LaTex-based toolchain. The contrast between http://www.docs.python.org/2.5 and http://www.docs.python.org/2.6 is stark enough, but the difference is even greater when you compare the
readability of the documentation files themselves:
Sphinx: http://hg.python.org/cpython/file/default/Doc/whatsnew/2.5.rst
LaTeX: http://hg.python.org/cpython/file/2.5/Doc/whatsnew/whatsnew25.tex


Nick Coghlan
Red Hat Engineering Operations, Brisbane

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]