根据 PyPA 规范,上传到 Pypi 时应该可以使用 markdown 格式的自述文件。
我不太明白的是把这条配置线放在哪里。我怀疑它必须是 PKG-INFO 但 a( 它不起作用(我在setup.py dist
之后手动添加它(和 b( 我认为它不打算手动添加。
我还做的是在 Manifest.in 中添加 README.md
include README.md
并在设置中指定它.cfg:
[metadata]
description-file = README.md
你可以在这里看看我的回购。
但是,pypi 上没有显示任何内容,就好像没有自述文件一样。
我完全知道 RST 是推荐的方式,网络上的大多数内容都是关于如何将 MD 转换为 RST,这对我也不起作用(可能是由于 RST 版本不兼容(。根据这篇博文和提到的 PyPA 规范,应该可以使用 markdown,我非常想这样做。
简介:(固定(
long-description-content-type = text/markdown
更新
prb 描述不正确
查看我的项目作为参考。在test.pypi和github上的源代码上。