python-3.x - 如何在 Sphinx :class: directive 后添加复数-s

Question

我一直有这个问题，我想写一个这样的文档字符串:

def foo(arg):
   '''Add ``arg`` to the list of :class:`foo.bar.baz.Argument`s.'''
   pass

但是，这不起作用，Sphinx 会警告说

py:class reference target not found: foo.bar.baz.Argument`s

所以它正在治疗 s在结束反引号作为类名的一部分之后。这不会发生在例如标点符号如点 . .
除了在类名和 Plural-s 之间添加一个空格(看起来很疯狂)之外，还有什么可以做的吗？

Answer 1

您应该可以使用 backslash-escaped whitespace .

def foo(arg):
   '''Add ``arg`` to the list of :class:`foo.bar.baz.Argument`\ s.'''
   pass