Python 如何在不丢失最新代码的情况下自动将类图插入sphinx apidoc

Python 如何在不丢失最新代码的情况下自动将类图插入sphinx apidoc,python,python-sphinx,Python,Python Sphinx,我想生成Python程序的文档 当我生成文档时,我总是执行sphinxapidoc来追踪最新的代码,然后执行makehtml $ sphinx-apidoc -f -o doc . $ make -C doc html 我使用sphinx.ext.heritation\u图来生成类图。如果将以下文本手动插入到.rst文件中,则可以生成类图 .. inheritance-diagram:: mymodule.MyClass1 mymodule.MyClass2 :parts: 1 但是

我想生成Python程序的文档

当我生成文档时,我总是执行
sphinxapidoc
来追踪最新的代码,然后执行
makehtml

$ sphinx-apidoc -f -o doc .
$ make -C doc html
我使用
sphinx.ext.heritation\u图来生成类图。如果将以下文本手动插入到.rst文件中,则可以生成类图

.. inheritance-diagram:: mymodule.MyClass1 mymodule.MyClass2
    :parts: 1
但是,上面的文本被
sphinx apidoc-f
删除。我想知道如何将类图插入到sphinx apidoc自动中,而不丢失最新代码

如果可能的话,我想指定类图插入的位置(例如,对于每个
.automodule::
或任何其他好方法,在插入之前)

我的环境:

$ python3 --version
Python 3.5.2
$ pip3 --version
pip 8.1.1 from /usr/lib/python3/dist-packages (python 3.5)
$ pip3 freeze | grep Sphinx
You are using pip version 8.1.1, however version 9.0.1 is available.
You should consider upgrading via the 'pip install --upgrade pip' command.
Sphinx==1.5.2

为此,您必须创建自己版本的sphinx apidoc。看,谢谢你的建议。我将尝试修改sphinx apidoc本身。