如何在Sphinx Myst中跨文档链接至脚注?
跨Myst文档链接脚注的问题
我正在用Sphinx + Read the Docs主题 + Myst编写项目文档,想要实现跨Myst文件链接脚注,期望能用类似以下的语法:
See {ref}`Footnote %s <example.md/footnote-label>` in the {ref}`examples` page.最好能自动把
footnote-label替换成对应的脚注编号,退一步说,只要能给脚注添加可被链接的锚点也行。目前跨文档链接章节标题、自定义锚点、公式、图表等都能正常工作,同一Myst文件内的脚注使用也没有问题,文档最终以HTML格式渲染。
我没在Myst的官方文档里找到对应的实现方法,虽然可以通过硬编码渲染后的HTML文件路径来实现链接:
[this footnote](document-base/example.html#footnote-label)但更希望能通过某种方式让Sphinx/Myst自动解析这类引用,不用手动维护路径。
编辑补充:
按照建议给脚注添加自定义标签后,代码如下:
I am writing a paragraph that requires a footnote.[^the-footnote] (my-footnote)= [^the-footnote]: This is what a footnote looks like. More stuff...
使用{ref}my-footnote``进行链接时,跳转的位置是More stuff...之前的段落末尾,而不是页面底部实际显示脚注内容的位置。
内容的提问来源于stack exchange,提问作者William Seligman
相关产品推荐
相关产品推荐

