Sphinx:链接到嵌入式二进制文件(PDF)

SliverNinja-MSFT

我正在使用sphinxRST以HTML格式生成一些技术文档,但在获取本地PDF参考作为超链接时遇到问题。我见过人们:download:习惯于链接到本地​​PDF,但是我将PDF嵌入/docs目录中以供参考。我不喜欢,:download:因为它不会在浏览器中内联显示PDF,这需要用户采取额外的步骤才能使用。

sphinx-build -b html除非在config.py钩子html_static_pathhtml_extra_path-中指定了文件,否则不会复制任何文件,即使它们被放置到root目录或_static文件夹中也是如此。

是否有建议的方法将链接的二进制文件嵌入在狮身人面像中,或者这是一种较差的做法?通常,链接是指向未在其他任何地方托管的滑板或设计图。

样本RST用于链接的PDF

.. important:: View the agile course on scrum basics

    - View `these slides to dive deeper into Agile Basics <docs/agile-101.pdf>`_. 
SliverNinja-MSFT

我想出的解决方案是仅将PDF添加到html_static_path_static在链接中引用输出路径,而不是docs其在源代码中的路径。现在,PDF在浏览器中打开,而无需下载即可查看。

如果有一个狮身人面像扩展名/指令来处理此(:download-inline:),那就太好了

conf.py

html_static_path = ['_static', 'agile-101/docs']

敏捷101

.. important:: View the agile course on scrum basics

- View `these slides to dive deeper into Agile Basics <../_static/agile-101.pdf>`_. 

本文收集自互联网,转载请注明来源。

如有侵权,请联系 [email protected] 删除。

编辑于
0

我来说两句

0 条评论
登录 后参与评论

相关文章

Xcode 6嵌入式二进制文件

什么时候应该在Xcode中使用“嵌入式二进制文件”而不是“链接框架”?

Swift Xcode无法从项目中删除嵌入式二进制文件/链接的框架和库

无法在Xcode中嵌入嵌入式项目的二进制文件

Qt 5.x嵌入式调试-部署剥离二进制文件?

Xcode:嵌入式二进制文件上的相对路径

如何为没有嵌入式二进制文件的iOS构建动态框架?

带有iOS框架的嵌入式二进制文件

什么是Xcode中的嵌入式二进制文件?

何时检查嵌入式二进制文件的“如果需要,复制项目”?

xcode使用buildscript添加嵌入式二进制文件

通过二进制字符串或base64在Internet Explorer 11中显示嵌入式PDF

查找二进制文件链接到的库

iOS错误“嵌入式二进制文件未使用与父应用程序相同的证书签名”

自定义Cordova插件:将框架添加到“嵌入式二进制文件”

使用相同的证书签名但出错:嵌入式二进制文件未使用相同的证书签名

如何解决:嵌入式二进制文件未使用相同证书签名

错误:嵌入式二进制文件未使用与父应用程序相同的证书进行签名

如何在SwiftUI Mac应用程序中运行嵌入式二进制文件?

嵌入式二进制验证实用程序错误

删除“ DerivedData”后,Xcode不会添加“嵌入式二进制”

生成WatchKit App-嵌入式二进制验证实用程序

始终“临时代码已签名”以获取嵌入式二进制签名证书

Xcode6:嵌入式二进制文件未使用与父应用程序相同的证书签名

嵌入式二进制文件未使用与父应用程序相同的证书签名,但是它们是相同的

嵌入式二进制文件的捆绑包标识符不以父应用程序的捆绑包标识符为前缀

将二进制链接与库VS嵌入框架

如何强制golang将文件链接到我的二进制文件中?

如何将* .o目标文件链接到内核二进制文件中