[Distutils] [Catalog-sig] HTML in long description

Jannis Leidel jannis at leidel.info
Mon Aug 24 18:03:34 CEST 2009

> I often think: why not integrate Sphinx with PyPI's web page  
> generation? Perhaps a sphinx extension that would generate the  
> "front page" for PyPI containing long_description and download links  
> along with other pertinent metadata. Then, this "preview"  
> functionality can be flexibly added to distutils (which would  
> delegate to Sphinx anyway).
> Additionally, the entire documentation can also be attached to a  
> PyPI page, for instance:
>  http://pypi.python.org/pypi/Distribute would be the "front page"
> and:
>  http://pypi.python.org/pypi/Distribute/docs/api can be the api docs
> The same URL structure can be made available in the local preview (http://localhost:8800/pypi/Distribute/docs/api 
> ).
> <radical/crazy thinking>Hmm, why not merge bitbucket and PyPI (w/  
> sphinx, Distribute)? One stop Python development!

A lot less radical and working today:


which will add an upload_sphinx command to (setuptools based)  
setup.py, creates a zip file of your Sphinx build directory and  
uploads it to PyPI to show up at http://packages.python.org/ 
<package>/, e.g. http://packages.python.org/django-authority/.


More information about the Distutils-SIG mailing list