如何使用sphinx首先链接到文件？

Question

我正在撰写文档,我想包含pdf文件或zip档案的链接.如何使用第一语言和狮身人面像实现这一目标？

如果我这样做

here is a pdf file : `pdf <doc/mypdf.pdf>`_

它不起作用,因为在编译期间sphinx不复制doc目录的包含(我使用sphinx-quickstart生成的makefile).

相反,使用image指令:

.. image:: img/plop.png

sphinx会在构建目录中复制plop.png图像.如何获得pdf或zip存档的相同行为？

Answer 1

我在sphinx文档中找到了解决方案.

假设您mypdf.pdf在目录中有一个文件,这是一个简短的示例doc.目录doc和第一个文件必须位于同一目录中:

here is a pdf file :download:`pdf <doc/mypdf.pdf>`

请注意,您不能:download:在文件的路径和文件的路径之间放置空格.