reStructuredText:README.rst没有解析PyPI

Question

我有一个托管在Github和PyPI上的Python项目.

在Github上:https://github.com/sloria/TextBlob/blob/master/README.rst

在PyPi上:https://pypi.python.org/pypi/textblob

我的README.rst似乎没有在PyPI上正确格式化,但它在Github上看起来很好.

我已经读过这个了,但是我没有任何页内链接,所以这不是问题所在.

Answer 1

您正在使用较新的文字角色:code:.

的PyPI似乎仅支持docutils的0.8,具有code和code-block添加到的PyPI解析器直接的,这意味着:code:是不支持.

GitHub使用较新版本的docutils(0.9或0.10).

:code:完全删除:

:code:`sentiment`

有:

`sentiment`

等等

Answer 2

对于我最近上传的一个包,问题是README.rst我们的贡献指南中的相对链接(不是页内链接),它在GitHub上渲染得很好,但是在PyPI上渲染渲染.

为了解决这个问题,我暂时将链接转换为一个名为的绝对链接

python setup.py register

更新元数据并在不提交的情况下撤消更改.