文档字符串未填充 Sphinx 文档

Question

我正在尝试为我的 Python 应用程序生成 Sphinx 文档。本来我有一个复杂的结构如下...

venv
docs
├───source
├───├───_static
├───├───_templates
├───├───conf.py
├───├───index.rst
├───├───modules.rst
├───├───...
├───build
├───make.bat
├───Makefile
├───MyCode
├───├───Utilities
│   │   └───class1.py
├───├───Configurations
│   │   ├───Archive
│   │   ├───API1_Configurations
│   │   │   ├───Config1.ini
│   │   ├───API2_Configurations
│   │   │   ├───Config2.ini
│   │   ├───API3_Configurations
│   │   │   ├───Config3.ini
│   │   ├───API4_Configurations
│   │   │   ├───Config4.ini
├───├───APIs
│   │   ├───API1
│   │   │   ├───Class1.py
│   │   │   ├───Class2.py
│   │   ├───API2
│   │   │   ├───Class1.py
│   │   │   ├───Class2.py
│   │   │   ├───Supporting
│   │   │   │   └───Class1.py
│   │   ├───API3
│   │   │   ├───Support
│   │   │   │   ├───SupportPackage1
│   │   │   │   ├───Support Package2
│   │   │   │   │   └───Class1.py
│   │   │   │   └───__pycache__
│   │   │   └───Class1.py

在这种情况下，我的源代码存在于./docs/MyCode.

我正在使用...

Python 3.8
Sphinx 4.2（虽然我试过很多版本）
NumPy 文档字符串

我有...

添加了以下扩展
- sphinx.ext.autodoc
- sphinx.ext.apidoc
- sphinx.ext.napoleon
使用相对路径和绝对路径（相对路径为 ../MyCode）将 conf.py 指向我的代码。

出于某种原因，我最接近用我的文档实际填充 HTML 页面的只是在索引 toctree 中包含类。他们 link 空白 html 页没有我的 Python 文档字符串。

有谁知道为什么它不获取我的文档字符串？

Answer 1

好吧...对此感觉很愚蠢，但这只是警告的原因。

Sphinx 要求该包是一个完全可安装的包，因为当它被放入 sphinx 包中时，它应该能够编译。我的导入语句中有一些绝对引用导致我的程序失败。因此，当类的名称仍然显示在我的狮身人面像 html.

中时，无法提取我程序中的实际文档字符串

基本上确保您的代码在尝试将其放入 Sphinx 时可以编译。

文档字符串未填充 Sphinx 文档

Docstrings not populating Sphinx documentation

python

python-sphinx

docstring