README.rst无法在PyPi上呈现

ais*_*ant 3 python restructuredtext pypi

我有一个README.rst在我的项目托管在GitHub上。它可以在GitHub上很好地呈现,但是无法在PyPi上呈现,即我在PyPi项目描述页面上看到了原始内容。

我研究了类似的问题,并使用python setup.py -rrstcheckcollection.checkdocs检查了rst格式,所有这些都不会引发任何错误。没有相对链接或内部链接。我不确定问题出在哪里以及如何解决。

我知道这个问题已经被问过很多次了。我想我已经尝试了所有解决方案,但它们对我没有用,这就是为什么我再次询问。

Ste*_*rcy 5

请参阅如何确保README.rst有效的答案

python setup.py check -r -s
running check
warning: Check: :11: (WARNING/2) "raw" directive disabled.

warning: Check: Invalid markup which will not be rendered on PyPI.

error: Please correct your package.
Run Code Online (Sandbox Code Playgroud)

要修复,请不要使用raw指令,而应使用image具有各种属性的指令

.. image:: https://plot.ly/~aishpant/1.png?share_key=8mG4JmyySLLYjbjTg7Uy62
   :target: https://plot.ly/~aishpant/1/?share_key=8mG4JmyySLLYjbjTg7Uy62
   :align: center
   :alt: sysfs line plot
   :width: 600px
Run Code Online (Sandbox Code Playgroud)

  • 同样按照https://packaging.python.org/guides/making-a-pypi-friendly-readme/ (2认同)