在我的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生成的。
答案 0 :(得分：1)
您可以在ref中使用带有文本覆盖的尖括号，或者将它们省略。换句话说，除非您要添加覆盖文本，否则请删除尖括号。
错误信息应该更好。