README.rst 无法在 PyPi 上呈现

README.rst fails to render on PyPi

我在 GitHub. It renders fine on GitHub but fails to render on PyPi 上托管的项目中有一个 README.rst,即我在 PyPi 项目描述页面上看到了原始内容。

我查看了类似的问题并使用 python setup.py -r 和包 rstcheck & collective.checkdocs 检查了第一种格式,所有这些都没有抛出任何错误。没有相对链接或内部链接。我不确定这里的问题是什么以及如何解决这个问题。

我知道这个问题已经被问过很多次了。我想我已经尝试了所有的解决方案,但它们都不适合我,这就是我再次提问的原因。

查看我的回答
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.

要修复,请不要使用 raw 指令,而是使用 image directive with its various attributes:

.. 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