This paper shares our experience converting matplotlib's documentation to use Sphinx and will hopefully encourage other projects to do so. Matplotlib's documentation serves as a good test case, because it includes both narrative text and API docstrings, and makes use of automatically plotted figures and mathematical expressions.

M Droettboom, Matplotlib Solves the Riddle of the Sphinx in Proceedings of the 7th Python in Science conference (SciPy 2008), G Varoquaux, T Vaught, J Millman (Eds.), pp. 29-32

BibTeX entry

Copyright The content of the articles of the Proceedings of the Python in Science Conference is copyrighted and owned by their original authors.
Terms of use For republication or other use of the material published, please contact the copyright owners to obtain permission.