sphinx-apidoc在生成的文件

Question

我的目录如下（此处未列出正确的__init__.py文件）：

root
    package1/
        subpackage1/
          submodule1.py
        module1.py

    package2/
        module2.py

    docs/

正在运行sphinx-apidoc . --full -o docs -H 'MyProject' -A 'MyName' -V '1.0'我几乎得到了我需要的一切：

• index.rst
• package1.rst
• package1.subpackage1.rst
• package2.rst

index列出了package1和package2 ，但 package1未列出package1.subpackage1。

我不想手动编辑package1.rst，因为它无法针对大型项目进行扩展，无法手动列出每个子包。