Python文档工具

Question

我正在研究开源工具和包，以便为包含docstring的模块和函数生成Python文档。

我知道斯芬克斯很适合解析用reStructuredText标记语法编写的手动创建的文档字符串。

我发现的第二个相关选项是埃皮多克，它也可以解析reStructuredText。它似乎是自动化的，而不是手动的，并且专注于记录API。

这两种工具都有用例包括这两种工具吗？

这里还有什么其他的工具可以考虑吗？

Answer 1

截至2018年2月，孔德刚的媒体文章对可用的Python文档工具进行了很好的回顾。

似乎epydoc可能不支持Python3，并且已经开发了后续的。Sphinx提供了更全面的解决方案，而Pdoc更易于安装，并且可能满足较小项目的需要。