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
我在 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