[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:
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
More information about the Distutils-SIG
mailing list