python3的文档生成器[关闭]

Question

我最近有为我的小项目生成文档的冲动。我认为这会相当容易，因为我有一组很好的文档字符串。事实证明，python 3.1 中的整个过程要复杂得多。

这是我尝试过的：

• epydoc：失败，因为它适用于 python 2。2to3 没有解决问题
• pydoc：我找不到任何信息，您如何为自己的模块生成文档，看起来像是离线阅读 python 文档的服务器
• sphinx：到目前为止，最有希望的是，我已经从他们的存储库中构建了它，但是它失败并显示了一个非常神秘的错误消息 (jinja2.exceptions.UndefinedError: b'b"\'sphinx.jinja2glue.idgen object\'没有属性\'next\'")

我的问题是：我现在该怎么办？是否有任何其他适用于 python3 的非商业文档生成器？

Answer 1

显然在 Jinja 中，X.next() 正在执行某些操作。在 Python 3 中是 next(x) 。这应该是一个简单的修复。