Python:Sphinx:如何在sphinx文档中自动包含所有类,方法和函数?

Jon*_*Jon 15 python python-sphinx

可能重复:
Sphinx - 结合自动模块和autoclass

我尝试使用sphinx及其autodoc插件为包含数千个类的项目创建一个html文档.sphinx-apidoc创建了精彩的rst文件,但缺少自动创建autoclassesautomethods.

sphinx中有一个方法/命令/实用程序可以自动包含文档中的所有变量,函数,类和装饰器吗?

一个rst文件的一些示例代码:

tagger Package
=================

:mod:`tagger` Package
------------------------
.. automodule:: project.tagger
    :members:


:mod:`client` Module
--------------------
.. automodule:: project.analyzers.tagger.client
    :members:
Run Code Online (Sandbox Code Playgroud)

Nil*_*esh 5

有一个 Sphinx 扩展可以帮助你完成这个叫做autodoc 的工作

如果要包含该类,则必须编写:

.. autoclass:: <ClassName>
Run Code Online (Sandbox Code Playgroud)

同样对于一个方法:

.. automethod:: <MethodName>
Run Code Online (Sandbox Code Playgroud)

  • 我使用自动文档。这意味着我必须添加 ..autoclass 超过一千次或创建一个脚本。不是有自动检测吗? (10认同)
  • 你可以使用`automodule` 如果你想自动记录成员,有一个成员选项。请检查链接。autodoc 扩展中有很多选项。 (3认同)