python - 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 上看起来没问题。

我已经读过this ，但我没有任何页内链接，所以这不是问题所在。

Answer 1

历史记录:这个答案涵盖了不再使用的 PyPI 版本，因为它已被名为 Warehouse 的新服务器取代。 ，它一直在跟踪 docutils 的发布(在本说明发布时为 0.16)。如果您今天在重构文本呈现方面遇到问题，此答案将不再对您有帮助。

原始答案如下。

---

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

PyPI 似乎只支持 docutils 0.8，将 code 和 code-block 直接添加到 PyPI 解析器中，这意味着 :code: 不受支持。

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

完全删除 :code: 角色，替换为:

:code:`sentiment`

与:

`sentiment`

等等