Sphinx 没有创建交叉引用链接

Question

任何想法为什么 sphinx 不创建交叉引用链接？

我已经尝试了所有可能的组合来尝试获得工作链接，但没有运气。我试过napoleon_google_docstring打开和关闭。

其他自动创建的引用工作正常。

Answer 1

您正在使用单引号而不是反引号来分隔角色内容。例如，:func:'atest'必须更改为:func:`atest`.

参考：

• http://www.sphinx-doc.org/en/latest/markup/inline.html
• http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#interpreted-text