将PDF文件链接为静态内容的自定义角色

问题描述

我正在尝试为Sphinx编写一个自定义角色，以允许链接到随后在浏览器中显示的PDF文件(而不是在使用:download:角色时下载)。

我已经获得了一个创建指向PDF文件的链接的角色：

:pdf:`Document Title <pdf/document.pdf>`

生成如下内容：

<a href="pdf/document.pdf>Document Title</a>

但是，我不知道如何让Sphinx将pdf目录复制到输出目录。 这可能吗？

---

解决方案

在conf.py中使用html_static_path。

html_static_path = ['_static', 'pdf']