link PDF 文件的自定义角色作为静态内容

Custom role to link PDF file as static content

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

我已经得到了创建 PDF 文件 link 的角色:

: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']