Use Pandoc to publish RestructuredText to PyPI

[pydanny]

A little call out to Pandoc during the publish setup.py command would mean this:

would look more like:

If this is something wanted, I'm more than happy to make the pull request.

[jpadilla]

I'd be ok if we just had moved our README.md to reStructuredText instead. That file only changes when a new version is released.

[tomchristie]

@pydanny sounds good. I'd probably rather see/review that first, before considering using .rst for the README

[mblayman]

As reported in #4012, the pandoc reST output is not rendering properly on PyPI. PyPI doesn't really report these errors easily so here is some output that can hopefully help resolve the problem. On other projects, when I've resolved any errors from rst2html, the page starts to render properly on PyPI.

python setup.py --long-description | rst2html.py > /dev/null
<stdin>:110: (WARNING/2) Cannot analyze code. Pygments package not found.
<stdin>:145: (WARNING/2) Cannot analyze code. Pygments package not found.

Installing Pygments made the errors go away.

[xordoquy]

@mblayman We already have a fix for that, see the related issues list.

[mblayman]

I ran the above command from the stable branch that includes the merged PR referenced in the issues list. I did some triage and thought this might be new information.

My apologies if you were already aware of this.