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:
http://pypi.python.org/pypi/Sphinx-PyPI-upload
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/.
Jannis
_______________________________________________
Distutils-SIG maillist - [email protected]
http://mail.python.org/mailman/listinfo/distutils-sig
