如何在不使用完全限定名称的情况下在 Sphinx 中交叉引用函数

Question

考虑基本的 Sphinx RST 文件

.. automodule:: test.submod
   :members:

.. automodule:: test.submod2
   :members:

在conf.py中包含以下内容：

import os
import sys
sys.path.insert(0, os.path.abspath('.'))

extensions = [
'sphinx.ext.autodoc'
]

nitpicky = True

和一个基本的模块test

# test/__init__.py
from .submod import func
from .submod2 import func2

# test/submod.py
def func():
    """
    func docstring
    """

# test/submod2.py
def func2():
    """
    func2 docstring

    See also :func:`func`
    """

当我构建它时，我收到警告

/home/aaronmeurer/Documents/sphinx-test/test/submod2.py:docstring of test.submod2.func2:3: WARNING: py:func reference target not found: func

如果我检查构建的 HTML， func链接实际上并没有链接到func文档字符串。

我尝试添加

.. currentmodule:: test

到index.rst的顶部（请参阅https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#directive-py:currentmodule ），但这不起作用。

我希望能够在不写出完全限定名称test.submod.func的情况下交叉引用func每当我链接到它时（如果它没有在最终 HTML 中显示为完全限定名称，我也更喜欢）。