如何使内部链接在 Sphinx 输出（latexpdf）中工作？
How to make internal links work in Sphinx output (latexpdf)?
我按照本手册插入 links:
http://sphinx-doc.org/markup/inline.html#ref-role
然而，虽然内部 links 在 HTML 输出中完美工作，但它们在 PDF 中不起作用。应该是可点击的文本 link 只会变成斜体。
这是我的第一个：
This is my :ref:`reference <file-table3>`.
.. _file-table3:
.. container:: centeredtextbody
.. table:: There is my table
当我构建 html (make html) 时，一切都符合预期。当我通过 latex (make latexpdf) 构建 pdf 时，我的文件中没有 links（TOC 除外）
我做错了什么？我希望 link 出现在 html 和 pdf 输出中。
所以，我想出了我的问题。
我的架构是：
index.rst
text
..include: File.rst
File.rst
links stuff
问题是，我认为，sphinx 对我的第一个文档进行了两次解析（一次作为第一个文件，一次作为包含文件）。由于未知原因，这显然导致链接在乳胶中变为 \emph。
将 File.rst 更改为 File.txt 解决了问题。
这么多年后可能完全无关紧要，但为了完整起见：
运行 pdflatex 两次似乎有效。在第一遍中，latex 只意识到那里发生了一些事情，但它没有足够的信息来完成 link。第二遍，使用在第一遍创建的辅助文件，确实有足够的信息并且 link 已正确建立。
在 Latex 中通常需要两遍或更多遍才能确保所有 links - 特别是参考书目 links - 都是正确的 linked，所以我并不感到惊讶Sphinx 文档也是如此。
干杯！
我按照本手册插入 links:
http://sphinx-doc.org/markup/inline.html#ref-role
然而，虽然内部 links 在 HTML 输出中完美工作，但它们在 PDF 中不起作用。应该是可点击的文本 link 只会变成斜体。
这是我的第一个：
This is my :ref:`reference <file-table3>`.
.. _file-table3:
.. container:: centeredtextbody
.. table:: There is my table
当我构建 html (make html) 时，一切都符合预期。当我通过 latex (make latexpdf) 构建 pdf 时，我的文件中没有 links（TOC 除外）
我做错了什么？我希望 link 出现在 html 和 pdf 输出中。
所以，我想出了我的问题。
我的架构是：
index.rst
text
..include: File.rst
File.rst
links stuff
问题是，我认为，sphinx 对我的第一个文档进行了两次解析（一次作为第一个文件，一次作为包含文件）。由于未知原因，这显然导致链接在乳胶中变为 \emph。
将 File.rst 更改为 File.txt 解决了问题。
这么多年后可能完全无关紧要，但为了完整起见：
运行 pdflatex 两次似乎有效。在第一遍中，latex 只意识到那里发生了一些事情，但它没有足够的信息来完成 link。第二遍，使用在第一遍创建的辅助文件，确实有足够的信息并且 link 已正确建立。
在 Latex 中通常需要两遍或更多遍才能确保所有 links - 特别是参考书目 links - 都是正确的 linked，所以我并不感到惊讶Sphinx 文档也是如此。
干杯！