Python sphinx Sphinx apidoc不够自动化
我在一个大型回购中工作,有大约100个单独的文件夹,每个文件夹有20-30个子文件夹,每个子文件夹都包含自己的.py文件夹。目前,我必须使用sphinx apidoc命令为每个文件创建.rst文件,然后将路径添加到conf.py文件,然后将.rst文件添加到index.rst文件。是否有自动化的方法,这样所有这些都只需要几个命令就可以完成 扩展声明它将记录Python包。反过来,要求它们的文件(模块)包含在一个目录中,并且每个目录都包含一个名为Python sphinx Sphinx apidoc不够自动化,python-sphinx,Python Sphinx,我在一个大型回购中工作,有大约100个单独的文件夹,每个文件夹有20-30个子文件夹,每个子文件夹都包含自己的.py文件夹。目前,我必须使用sphinx apidoc命令为每个文件创建.rst文件,然后将路径添加到conf.py文件,然后将.rst文件添加到index.rst文件。是否有自动化的方法,这样所有这些都只需要几个命令就可以完成 扩展声明它将记录Python包。反过来,要求它们的文件(模块)包含在一个目录中,并且每个目录都包含一个名为\uuuu init\uuuu.py的文件 正确设置
\uuuu init\uuuu.py
的文件
正确设置文件和目录后,Sphinx可以导入它们并按预期运行
Sphinx autodoc
。您使用什么命令?如果您使用正确的选项,并且目录中有\uuu init\uuuu.py
文件,使它们成为Python模块,那么您不必手动执行任何操作。我的问题是.rst文件不是递归创建的,我必须将这些路径添加到conf.py文件中。您的文件夹中是否有\uuuu init\uuuuuuupy.py
使它们成为Python模块,因此可以通过sphinx apidoc
发现?您是否尝试了-模块路径
,-单独的
,或-隐式名称空间
来查看它们的功能?我使用init.py获得了它