从sphinx autodoc发出reStructuredText?

nco*_*lan 20 python python-sphinx

CPython不使用autodoc作为其文档 - 我们使用手写的散文.

对于PEP 3144(ipaddress模块​​),我想使用sphinx-apidoc生成初始参考文档.这意味着我想要运行两遍操作:

  1. 使用sphinx-apidoc为依赖于autodoc的模块发出Sphinx项目

  2. 运行sphinx构建器,创建新的reStructuredText源文件,所有autodoc指令替换为内联reStructuredText内容和生成相同输出的标记

第一步很简单,但我不知道如何进行第二步,甚至无法想出以这些方式搜索任何现有项目的好方法.

Mic*_*hař 9

我有同样的问题,并且一次生成文档我使用了非常难看的解决方案来修补Sphinx,请参阅Make Sphinx从pydoc生成RST类文档.