我在本手册后插入链接:
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输出中。
答案 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解决了这个问题。