On Fri, 21 Aug 2009 08:05:47 -0700, Martin v. Löwis <[email protected]> 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
_______________________________________________
Distutils-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/distutils-sig

Reply via email to