如何使内部链接在Sphinx输出(latexpdf)中工作?

时间:2015-02-24 09:29:06

标签: reference latex python-sphinx restructuredtext

我在本手册后插入链接:

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输出中。

2 个答案:

答案 0 :(得分:1)

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

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

在Latex中,通常需要两次或更多次验证,以确保正确链接所有链接(特别是书目链接),因此对于Sphinx文档也是如此,这不足为奇。

干杯!

答案 1 :(得分:0)

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

我的架构是:

index.rst

    text

    ..include: File.rst


File.rst

    links stuff

我认为问题是,sphinx正在解析我的第一个文档两次(一次作为第一个文件,一次作为包含文件)。由于不明原因,这显然导致乳胶中的链接成为\ emph。

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