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

Sridhar Ratnakumar sridharr at activestate.com
Sat Aug 22 04:05:22 CEST 2009


On Fri, 21 Aug 2009 08:05:47 -0700, Martin v. Löwis <martin at v.loewis.de>  
wrote:

> It might also be useful to have a
> distutils command that generates a pypi-like page, so that people can
> preview the rendered description.

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!

-srid


More information about the Distutils-SIG mailing list