python - 如何在 Sphinx 文档中将成员注释为摘要？

Question

autodoc以下两个属性定义在 Sphinx HTML 输出中显示完全相同：

@property
def concrete(self):
    """This is the concrete docstring"""
    pass

@abstractproperty
def abstract(self):
    """This is the abstract docstring"""
    pass

Sphinx 有办法用某种标识符注释抽象方法吗？我希望在我的文档中清楚地表明我的 ABC 的哪些成员需要实现，以及一旦定义了所需的那些是你得到的 mixin 免费赠品。

Answer 1

Sphinx 似乎无法做到这一点。自 2011 年以来，它在Sphinx 的 bitbucket中被标记为一个未解决的问题，并被标记为 Sphinx 未来版本的里程碑。