python3的文档生成器

Question

我最近感觉到为我的小项目生成文档的冲动。我认为这很容易，因为我有一套漂亮的文档字符串。事实证明，整个过程在python 3.1中要复杂得多。

这是我试过的：

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

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

Answer 1

显然在Jinja中，有些东西在做X.next（）。在Python 3中，接下来是（x）。这应该是一个简单的解决方案。