狮身人面像交叉引用不起作用

Question

在我的scipy风格的文档字符串中我有：

..., see :ref:`notes <filt_int_notes>`.

Other text.

.. _filt_int_notes:

Notes
-----
Some cool notes.

根据Adding a cross-reference to a subheading or anchor in another page和 http://sphinx-doc.org/markup/inline.html#role-ref

但是引用并没有生成链接！

我的docstrings是通过autosummary生成的。

Answer 1

您可以在ref中使用带有文本覆盖的尖括号，或者将它们省略。换句话说，除非您要添加覆盖文本，否则请删除尖括号。

错误信息应该更好。