跨页或等效的 Sphinx 脚注

Sphinx footnotes across pages or equivalent

我有一份带有一些脚注的文档:

doc.rst

This sentence needs clarification\ [#fn1]_.

如果我将脚注放在同一个文件中,它就可以正常工作。但是,我想要一个单独的文件,其中包含来自几个不同文档的脚注:

supplement.rst

[#fn1] A word of explanation.

这给了我两组警告。首先是 supplement.rst 中的警告:

...supplement.rst:1: WARNING: Footnote [#] is not referenced.

然后 doc.rst 中的一对警告:

...doc.rst:1: WARNING: Too many autonumbered footnote references: only 0 corresponding footnotes available.
...doc.rst:1: WARNING: Unknown target name "fn1".

doc.html 中的引用呈现为带有文本 [#fn1]_ 的 link,无处可去,supplement.html 中注释左侧的数字显示为灰色出。

如何在 sphinx 中实现跨文档脚注?

脚注的范围仅限于文档,而不是整个文档集的全局范围。您可以实施 citations or a glossary.