我可以使用WordPress来为PyPI文档页面供电吗？

Question

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

Answer 1

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

---

首先，在包页面上有文档。

这只是你的long_description，解析为重构结构文本。所以，该文档不能由WordPress提供。

我想你可以间接地从一个WordPress站点拉它，如果你设置了现场，出示您的文档的纯文本或RST版本，并没有这样的事情在你的setup.py：

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

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

---

接下来，你可以在pythonhosted.org上传你的软件包的pkg_edit页的文件，或在distribute/setuptools使用upload_docs功能添加文档。

这只是一个充满静态页面的树。所以，该文档不能由WordPress提供。

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

---

最后，你可以添加一个主页，这是一个链接到你想要的任何网站。

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