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