如何使内部链接在 Sphinx 输出（latexpdf）中工作？

Question

我按照本手册插入链接：

http://sphinx-doc.org/markup/inline.html#ref-role

然而，虽然内部链接在 HTML 输出中完美运行，但它们在 PDF 中不起作用。 应该是可点击链接的文本只会变成斜体。

这是我的第一个：

This is my :ref:`reference <file-table3>`.

.. _file-table3:

.. container:: centeredtextbody

    .. table:: There is my table

当我构建 html (make html) 时，一切都按预期进行。 当我通过 latex (make latexpdf) 构建 pdf 时，我的文件中没有链接（TOC 除外）

我究竟做错了什么？ 我希望链接同时出现在 html 和 pdf 输出中。

Answer 1

这么多年后可能完全无关紧要，但为了完整起见：

两次运行pdflatex似乎有效。 在第一次传递中，latex 只意识到那里发生了一些事情，但它没有足够的信息来完成链接。 第二遍，使用在第一遍创建的辅助文件，确实有足够的信息并且链接正确建立。

在 Latex 中通常需要两次或多次通过以确保所有链接 - 特别是参考书目链接 - 正确链接，所以我并不奇怪 Sphinx 文档也是如此。

干杯!

Answer 2

所以，我想出了我的问题。

我的架构是：

index.rst

    text

    ..include: File.rst


File.rst

    links stuff

问题是，我认为，sphinx 解析了我的 rst 文档两次（一次作为 rst 文件，一次作为包含文件）。 由于未知原因，这显然导致链接在乳胶中变为 \\emph。

将 File.rst 更改为 File.txt 解决了问题。