python3 的文档生成器

Question

已结束。此问题正在寻求书籍、工具、软件库等的推荐。它不满足 Stack Overflow guidelines 。目前不接受答案。

---

我们不允许提出寻求书籍、工具、软件库等推荐的问题。您可以编辑问题，以便用事实和引文来回答。

已关闭 5 年前。

Improve this 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)。这应该是一个简单的修复。