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

【问题标题】：How to make internal links work in Sphinx output (latexpdf)?如何使内部链接在 Sphinx 输出（latexpdf）中工作？
【发布时间】：2015-04-25 20:37:25
【问题描述】：

我在本手册之后插入链接：

但是，虽然内部链接在 HTML 输出中可以正常工作，但它们在 PDF 中却不能正常工作。应该是可点击链接的文本只会变成斜体。

这是我的第一个：

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

.. _file-table3:

.. container:: centeredtextbody

    .. table:: There is my table

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

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

【问题讨论】：

【解决方案1】：

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

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

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

干杯！

【讨论】：

【解决方案2】：

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

我的架构是：

index.rst

    text

    ..include: File.rst


File.rst

    links stuff

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

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

【讨论】：