Sphinx перекрестная ссылка не работает

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

Либо вы можете использовать угловые скобки с переопределением текста в рефлекторе, либо оставить их вне. Другими словами, удалите угловые скобки, если вы не собираетесь добавлять текст переопределения.

Сообщение об ошибке должно быть лучше.