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

Question

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

Answer 1

有三种与 PyPI 包相关的文档。

---

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

这只是你的long_description，被解析为 ReStructured Text。因此，WordPress 无法提供该文档。

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

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

……但我不认为你想那样做。

---

接下来，您可以pythonhosted.org通过从包页面上传文件pkg_edit或使用/中的upload_docs功能来添加文档。distributesetuptools

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

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

---

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

当然，这可以是一个 WordPress 网站。