如何在Sphinx文档中包含PDF？

Question

我有一个PDF文件，里面详细解释了我使用的一个包在Sphinx文档中的例子。请问有没有简单的方法可以把这个PDF包含到我的项目里（并且在我生成文档时能自动复制过去）？我试着用 :doc: 来链接它，但这样并没有把它复制过去。

Answer 1

使用 :download: 这个文本角色可以引入一个额外的文件。举个例子，你可以这样做：

For an in-depth explanation, please see :download:`A Detailed Example <some_extra_file.pdf>`.