python - 类docstring块内的类属性docstring

我正在用Sphinx记录我的Python项目，并希望在类docstring块内记录类属性。属性内联文档字符串很难看。

我确实尝试将属性docstring添加到类docstring块中，但是当Sphinx制作html时，它无法正确显示。

class MyClass():
    """
        MyClass docstring block.

        Attributes:
            name - A single attribute.
            :attr name - A single attribute.
    """

    name = "ABC"

生成的html显示一条简单的行。而是使用属性内联docstring显示漂亮的样式。

Attribute inline docstring

Attribute docstring in class block docstring

最佳答案

您应该在属性名称后加上一个冒号：

class MyClass():
    """MyClass docstring block.

        Attributes:
            name: A single attribute.
            name: A single attribute.
    """

    name = "ABC"

关于python - 类docstring块内的类属性docstring，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/54009886/