[Distutils] [Catalog-sig] HTML in long description
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>
> 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"
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
<radical/crazy thinking>Hmm, why not merge bitbucket and PyPI (w/ sphinx,
Distribute)? One stop Python development!
More information about the Distutils-SIG