project-callisto/callisto-core

fix pypi markdown parser

Opened this issue · 5 comments

https://pypi.python.org/pypi/callisto-core <= the markdown there is very clearly not parsed!

r4dat commented

I've reviewed previous releases on pypi and it looks like parsing breaks between 0.9.2 and 0.10.0 - while I'm in the midst of looking for the root cause, an alternative solution is to write the readme as restructured text instead of markdown and skip the pandoc conversion altogether.

Since GitHub can parse both anyway, is there any specific reason to stick with markdown?

@r4dat

As much as having to do the pandoc conversion annoys me (quite a bit) I prefer markdown enough relative to rst to want the readme in markdown.

All that's unimportant though! The Real Solution is here => pypi/warehouse#869 (comment)

Hi Callisto and hi @lynncyrin! You can now directly upload an sdist containing your README.md to your pypi.org project detail page without needing to use that pandoc conversion and it will also work for wheels once pypa/wheel#231 is sorted out and there's a new release of wheel. (Markdown support works if one uploads only an sdist, but if one uploads a wheel, or an sdist and a wheel, then Markdown support does not yet work.)

This does not work on pypi.python.org (legacy PyPI) which is going away probably by the end of April.

And if you as maintainers have any trouble using or uploading to the new PyPI, please let us know!

(I am still working on this draft explanation of what's new in the new PyPI but want to share it with you in this early form in case it helps or you have questions I could answer in it.)

@brainwane thanks ^^