Sphinx:在文档集中存在多个重复目标时引用特定目标

时间:2017-11-16 09:26:10

标签: documentation python-sphinx restructuredtext

在我目前使用Sphinx的文档项目中,我使用option 指令标记每个参数,我想在概要列表中创建对它的引用(使用{{ 1}} 角色):

option

如果参数是唯一的(仅存在于一个函数中),它可以正常工作。但是由于历史原因,我们的文档中有多个重复的参数,您可以在上面的示例行中看到它们(它们存在于不同的文件或同一文件中,显然我们无法更改名称)。它们并不多,但是当涉及到这些重复时,在概要中创建的链接将跳转到错误的位置(函数A中的链接-sub_interface_count最终在函数B中)。

有没有办法绕过这个(保留链接功能)?谢谢。

0 个答案:

没有答案