Sphinx:链接到外部PPT文档?

Question

我知道我能够添加到文档的其他部分或外部web链接(https://sublime-and-sphinx-guide.readthedocs.io/en/latest/references.html)的链接。但是是否有可能链接到外部文档，比如powerpoint PPT文件?

在web docs或PDF中，如果用户能够点击到PPT文件的链接，文件就会自动下载并打开。

谢谢你的真知灼见!

Answer 1

对于PDF和HTML，我的解决方案是将我所有的PPT文档放在_static/目录中，配置html_static_path变量，然后链接到所需的文件，像这样:

<<ol>

目录结构/gh>

repo-top/
conf.py
_static/
myDocument.pptx

conf.py

html_static_path = ['_static']

3. 您的RST文件

`Display Text <_static/myDocument.pptx>`_.

html_static_path相关文档https://www.sphinx-doc.org/en/master/usage/configuration.html confval-html_static_path

这似乎也是这里的方法:https://stackoverflow.com/a/67997311/6647191

1. 我也不得不手动替换所有的绝对文件:///url到相对的使用sed。然后，您必须将PDF与_static目录一起发送。这是在Mac上

export LC_CTYPE=C
export LANG=C
sed -i '' 's/file:///Users/username/Desktop/project/./g' ./_build/filename.pdf
cp -r _static/* ./_build/_static