微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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

如何解决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 举报,一经查实,本站将立刻删除。