9

我想在我的 Sphinx 文档中只包含特定函数的文档字符串。但是,似乎没有选项可以使用http://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html在没有关联的类和函数定义的情况下仅显示这些详细信息

我已经尝试创建一个类,如Show *only* docstring in Sphinx 文档中所述?但我不确定这如何适合模板。

我也尝试过 autodoc-process-docstring 事件处理程序,但没有成功。

因此,而不是我的文档显示(目前):

class module.MyClass(param)

    This is the class doc string

    my_method()

        This is my method doc string

我只想显示:

This is my method doc string

我当前在 .txt 文件中的模板是:

.. autoclass:: module.MyClass
    :members: my_method
4

1 回答 1

14

在查看源代码并进行实验之后 - 这是在 Sphinx 1.1 中的操作方法。

在您的 conf.py 文件中创建一个新的 MethodDocumenter 子类。在这里您可以设置一个新的“objtype”,确保文档字符串没有缩进,并删除标题。

from sphinx.ext import autodoc

class SimpleDocumenter(autodoc.MethodDocumenter):
    objtype = "simple"

    #do not indent the content
    content_indent = ""

    #do not add a header to the docstring
    def add_directive_header(self, sig):
        pass

然后确保将其添加到具有以下功能的可用文档中(再次在 conf.py 中):

def setup(app):
    app.add_autodocumenter(SimpleDocumenter)

然后,当您只想显示方法的文档字符串时,请在 .txt 或 .rst 文件中使用以下格式。只需在您的 objname 前加上 auto。

.. autosimple:: mod.MyClass.my_method
于 2011-10-20T07:20:08.647 回答