大数跨境

PyPI正式支持Markdown

PyPI正式支持Markdown Python程序员
2018-03-18
0
导读:我今天激动地宣布,PyPI支持使用Markdown编写项目描述了!

终于


我今天激动地宣布,PyPI支持使用Markdown编写项目描述了!这个特性是备受瞩目的,我们做了大量的工作,终于实现了这个特性。是直接的支持,而不是把Markdown转换为rST,或者是使用其他的Hack方式。


例如,这个示例项目使用了Markdown描述:

https://pypi.org/project/markdown-description-example/

这里是这个项目的源代码:

https://github.com/di/markdown-description-example


下面是为自己的项目添加Markdown描述的实现步骤:


有一个README.md


有一个README.md,并确保里面包含Markdown内容。文件后缀不必是.md(.mkdn/.markdown),后缀是什么都可以。只是你的setup.py确保会读取它并将内容设置给long_description


在setup.py中设置一个新参数


PEP566添加了一个新的元数据字段Description-Content-Type。为了给你的长描述添加内容类型,你需要把下面参数添加到setup.py中的setup函数调用中。

升级你的setuptools


为了支持上面添加的新的元数据,你需要升级你的setuptools版本到>=38.6.0。

当然你也必须确实是在使用setuptools进行打包,这意味着在你的setup.py中应该有这样一样引入语句:


构建发布源码


这一步跟以前没有区别


升级你的twine


同时你还要升级你的twine,需要版本>=1.11.0,否则设置的新的元数据不会被正确地发送给PyPI。

(--pre参数是需要的,因为目前我们需要这个参数来让twine升级到预发布版本)


上传你的发布版


这一步跟以前也一样


在pypi.org上查看你的项目


只有pypi.org能够正确地展示你的Markdown描述,以前的pypi.python.org只会将Markdown代码作为纯文本展示,不过别担心,旧的网站很快就要下线了


致谢


感谢Marc Abramowitz完成了这个特性的初版,感谢Nick Coghlan和Daniel Holth指导我通过了PEP的认证和审核,感谢Tres  Seaver, Sumana Harihareswara,  Jason R. Coombs 审核、测试并发布了这个特性,感谢配合我完成这个特性的整个PyPI团队,包括Nicole Harris, Ernest W. Durbin III 和 Donald Stufft。


英文原文:https://dustingram.com/articles/2018/03/16/markdown-descriptions-on-pypi

译者:诗书塞外

【声明】内容源于网络
0
0
Python程序员
1234
内容 2525
粉丝 0
Python程序员 1234
总阅读0
粉丝0
内容2.5k