PyPI page shows ReST source

[Marius Gedminas]

http://pypi.python.org/pypi/lazr.enum shows the ReStructuredText markup source instead of a prettily formatted page. The reason for this is usually invalid ReST markup. In this particular case it seems to come from Sphinx directives (.. toc-tree:) that basic ReST doesn't define.

I've a proposed fix in a local Bazaar branch. Now if only I could figure out how to attach that fix to this bug report...

[Tim Penhey (thumper)]

Francis, is this in the default lazr package? If it is we'd probably want to put this change in there too.

[Tim Penhey (thumper)]

Fix landed on trunk at r27.

[Tim Penhey (thumper)]

Actually, changing to only committed as the fix has landed but PyPI isn't yet updated.

[Gary Poster (gary)]

Thanks Tim, thanks Marius.

It is a general lazr.yourpkg template problem. Francis and I decided that this was not a priority problem at the moment.

My general plan to solve this for all lazr packages (subject to someone convincing me with another one) is to upload the Sphinx docs to http://packages.python.org/; and switch to having the top-level README provide the long description, and have it point to the Sphinx docs.

Marius' solution is fine for smaller packages, also.

Tim, I can update the package's registration today. Feel free to bug me if I haven't done it. If you give me your PyPI name I can grant you access too, if you like.

Gary