如何在嵌套目录中生成sphinx停靠点？

我想从嵌套文件夹结构中的脚本生成 sphinx autodoc 文档：

└── programs
    └── general_name
        └── another_folder
            ├── script1.py
            └── script2.py

由于某种原因， script1.py 和 script2.py 未与自动文档一起显示，我只能看到脚本名称：

programs.general_name.another_folder package

¶Submodules

programs.general_name.another_folder.script1 module
programs.general_name.another_folder.script2 module

完整文件夹结构：

../
├── docs
│   ├── _build
│   │   ├── doctrees
│   │   │   ├── environment.pickle
│   │   │   ├── index.doctree
│   │   │   └── rst
│   │   └── html
│   │       ├── genindex.html
│   │       ├── index.html
│   │       ├── objects.inv
│   │       ├── rst
│   │       ├── search.html
│   │       ├── searchindex.js
│   │       ├── _sources
│   │       └── _static
│   ├── conf.py
│   ├── index.rst
│   ├── make.bat
│   ├── Makefile
│   ├── rst
│   │   ├── modules.rst
│   │   ├── programs.general_name.another_folder.rst
│   │   ├── programs.general_name.rst
│   │   └── programs.rst
│   ├── _static
│   └── _templates
└── programs
    └── general_name
        └── another_folder
            ├── script1.py
            └── script2.py

我正在运行这个命令：

/docs $ sphinx-apidoc -f -o rst/ ../programs/ && make html

我也尝试过：

$ sphinx-apidoc -f -o rst/ ../programs/general_name/another_folder/ && make html

但是script1模块和script2模块在生成html文件时是空的。

解决方案：

找到导致问题的原因 - 破折号“-”。 another_folder 实际上被命名为 get_requests_from_server-10

将文件夹重命名为 get_requests_from_server_10 后，自动停靠开始工作

根据文档sphinx-apidoc:

sphinx-apidoc 是一个自动生成 Sphinx 源代码的工具，它使用 autodoc 扩展来记录整个 Sphinx 源代码package与其他自动 API 文档工具的风格相同。

源目录必须指向一个Python包.

（强调已添加）

根据这个所以答案:

任何Python文件都是module，其名称是文件的基本名称，不带.py扩大。 Apackage是 Python 模块的集合：模块是单个 Python 文件，而包是包含附加内容的 Python 模块的目录__init__.py文件，以区分包和恰好包含一堆 Python 脚本的目录。

首先添加一个空的__init__.py每一个sourcedir，看看是否可以解决问题。