Python：在单个模块上使用 Sphinx 生成自动文档？

Question

我正在开发一个只有一个 .py 模块的 Python 库，我正在尝试从文档字符串中为它生成文档。我已经设置了 Sphinx 并运行了 spinx-quickstart 脚本，但是当我尝试运行时（在 docs 目录中）

sphinx-apidoc ../cffiwrap.py -o .

但它只是说：

../cffiwrap.py is not a directory.

是否有其他一些 Sphinx 脚本可以自动记录单个文件？我想只针对它运行它，..但后来我认为它会运行到我的测试目录中并尝试从我的单元测试中生成文档......

Answer 1

手册说：

sphinx-apidoc [选项] -o packagedir [路径名 ...]

其中路径名是要排除的目录。

所以尝试：

sphinx-apidoc -o . .. ../test_dir 

wheretest_dir是你的测试所在的位置。