如何将 ref 指向包含 Sphinx 项目中另一个文档的文档？答案

【问题标题】：How to point ref to the document that includes another document in a Sphinx project?如何将 ref 指向包含 Sphinx 项目中另一个文档的文档？
【发布时间】：2012-09-20 17:45:49
【问题描述】：

我有一个重组文本文件的目录。

Index.rst 有一个 :ref: 指向 table.rst 中的一个部分。

table.rst 使用 ..include:: 指令包含在 Footnotes.rst 中。

Sphinx 将文件呈现为 html 后，Index.html 中的链接指向 table.html，而不是 Footnotes.html。如何获得指向 Footnotes.html 的链接，其中包含 table.html？

【问题讨论】：

标签： python python-sphinx restructuredtext

【解决方案1】：

尝试使用

:doc:`Footnotes.rst`

【讨论】：