python - 在 autodoc 中排除模块文档字符串

Question

我正在尝试在 Sphinx 中使用 autodoc 打印出特定模块中每个函数的文档字符串，但不包括模块的文档字符串。可能吗？

原因是我正在使用模块文档字符串来指定命令行选项(使用可爱的 docopt)。

Answer 1

将以下内容添加到 conf.py:

def remove_module_docstring(app, what, name, obj, options, lines):
    if what == "module" and name == "yourmodule":
        del lines[:]

def setup(app):
    app.connect("autodoc-process-docstring", remove_module_docstring)

此代码通过为 autodoc-process-docstring 提供处理程序来删除 yourmodule 模块中的模块文档字符串。事件。