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

Question

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

但是，尽管内部链接在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输出中。

Answer 1

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

我的体系结构是：

index.rst

    text

    ..include: File.rst


File.rst

    links stuff

我认为问题是狮身人面像两次解析了我的第一个文档（一次作为一个rst文件，一次作为一个包含文件）。显然，这导致链接在乳胶中变成\ emph，原因不明。

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

Answer 2

经过这么多年可能完全不相关，但出于完整性考虑：

两次运行pdflatex似乎有效。在第一遍中，乳胶仅意识到其中正在发生某些事情，但是它没有足够的信息来完成链接。第二遍使用第一个遍历上创建的辅助文件，确实具有足够的信息，并且链接已正确建立。

在Latex中，通常需要两次或多次传递，以确保正确链接所有链接（特别是书目链接），因此Sphinx文档也是如此。

干杯！