Sphinx RST :ref: 到特定文档中的一个部分

问题描述

我想在 Sphinx 中使用 :ref: 指令向特定文件中的标头添加交叉引用。我的问题是多个 RST 文件具有相似的标题结构,因此标题是重复的。所以我试图让 :ref: 与 autosectionlabel 一起工作,但我遇到了问题。

这适用于 'refer to my section <my_page.html#my_section>',其中 my_page.rst 带有部分标题 my_section。

但是,当我说 :ref:'my_page:my_section' 时,我收到警告:未定义标签

为了确保我有正确的 my_page.rst 相对路径,我还尝试了 :doc:my_page 并且有效,所以至少我知道 :doc: 有效而 :ref: 无效工作

我浏览了此处的答案,找到了此链接 Adding a cross-reference to a subheading or anchor in another page,但这些答案对我不起作用。

解决方法

暂无找到可以解决该程序问题的有效方法,小编努力寻找整理中!

如果你已经找到好的解决方法,欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@)