在我目前使用Sphinx的文档项目中,我使用option
指令标记每个参数,我想在概要列表中创建对它的引用(使用{{ 1}} 角色):
option
如果参数是唯一的(仅存在于一个函数中),它可以正常工作。但是由于历史原因,我们的文档中有多个重复的参数,您可以在上面的示例行中看到它们(它们存在于不同的文件或同一文件中,显然我们无法更改名称)。它们并不多,但是当涉及到这些重复时,在概要中创建的链接将跳转到错误的位置(函数A中的链接-sub_interface_count最终在函数B中)。
有没有办法绕过这个(保留链接功能)?谢谢。