交叉引用装饰器

Question

sphinx 中的 python 域有 .. py:decorator:: 记录装饰器，但如何交叉引用装饰器？

对于函数（用 .. py:function:: 记录）有 :py:func:。装饰器的等价物是什么？

Answer 1

我在 sphinx 的文档中找到了答案：

There is no py:deco role to link to a decorator that is marked up with this directive; rather, use the py:func role. http://sphinx-doc.org/domains.html#directive-py:decorator

官方的解决方案是使用:py:func:。它也有效。不幸的是，sphinx 在装饰器名称后添加了括号。

text py:func:`mydecorator` text

在输出中变为：

text mydecorator() text

brakets 可以全局禁用，但在引用实际函数时我非常喜欢它们。