python - 我可以使用 WordPress 来支持 PyPI 文档页面吗？

Question

您可以上传文档以与 PyPI 上的包一起运行，但我想知道这些文档是否可以使用 WordPress 托管。要求需要最新的 PHP 副本和 MySQL 数据库。 PyPI 文档系统是否提供此功能？

Answer 1

存在与 PyPI 包相关的三种文档。

<小时/>

首先，包页面本身有文档。

这只是您的long_description，解析为重构文本。因此，WordPress 无法提供该文档。

我想如果您将站点设置为呈现文档的纯文本或 RST 版本，并在 setup.py 中执行类似操作，您可以从 WordPress 站点间接提取它。 :

setup(
    # ...
    long_description = urllib.request.urlopen('http://example.com/path/to/mydocs').read()
)

...但我认为你不想这样做。

<小时/>

接下来，您可以通过从软件包的 pkg_edit 页面上传文件，或者使用分发/setuptools。

这只是一棵充满静态页面的树。因此，WordPress 无法提供该文档。

但是，您可以再次使用 WordPress 生成此文档，然后将其下载并提交给 PyPI。在这里，这似乎不是一个坏主意。

<小时/>

最后，您可以添加主页，它是指向您想要的任何网站的链接。

当然，这可以是 WordPress 网站。