狮身人面像交叉引用不起作用
Sphinx cross reference not working
在我的 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.
但是 ref 没有生成 link!
我的文档字符串是使用自动摘要生成的。
您可以在 ref 中使用带有文本覆盖的尖括号，也可以不使用它们。换句话说，删除尖括号（以及里面的内容），除非您要覆盖文本。
错误信息应该更好
在我的 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.
但是 ref 没有生成 link!
我的文档字符串是使用自动摘要生成的。
您可以在 ref 中使用带有文本覆盖的尖括号，也可以不使用它们。换句话说，删除尖括号（以及里面的内容），除非您要覆盖文本。
错误信息应该更好