python - 使用 intersphinx 解决 Sphinx 中引用中的名称冲突

Question

我正在为我的 python 库编写文档使用 sphinx，我还使用 intersphinx 添加了另一个 sphinx 文档。而且它工作得很好，但是我的一些函数的名称与参考文档中的名称相同，这导致它们的名称被遮蔽以供:func:...参考。

有什么方法可以do_some()在其他文档中引用阴影函数？（:func:`do_some`创建一个指向我的函数的链接do_some()）

Answer 1

根据文档，您可以使用您的标识符intersphinx_mapping作为目标的前缀。例子：

:ref:`comparison manual <python:comparisons>`

我认为这也应该与函数一起使用。