I'm delighted to announce that the Sphinx library, used to build the new Python documentation (for 2.6 and 3.0) [1], is now released for general use.
What is it? =========== Sphinx is a tool that makes it easy to create intelligent and beautiful documentation for Python projects (or other documents consisting of multiple reStructuredText source files). Its website is at <http://sphinx.pocoo.org/>. What does it do? ================ Sphinx is not an API documentation generator like Epydoc. Instead, its focus is on hand-written documentation, such as the Python one. * Main output formats: HTML (including HTML Help) and LaTeX * Extensive cross-references: semantic markup and automatic links for functions, classes, glossary terms and similar pieces of information * Hierarchical structure: easy definition of a document tree, with automatic links to siblings, parents and children * Automatic indices: general index as well as a module index * Code handling: automatic highlighting using the Pygments highlighter * Goodies such as changes overview, and external link checking What else? ========== Various extensions are available and in development: * autodoc: pulls in documentation from docstrings that are written in reST, to avoid having to maintain multiple documentation locations * doctest: automatically tests snippets in the documentation in doctest fashion * coverage: documentation coverage checker Cheers, Georg [1] http://docs.python.org/dev -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out. _______________________________________________ Doc-SIG maillist - Doc-SIG@python.org http://mail.python.org/mailman/listinfo/doc-sig
