Sphinx 文档:通过 latex 在 PDF 中包含 svg 图像

Sphinx documentation: Include svg images in PDFs via latex

我正在一家 IT 公司实习,该公司需要为其固件文档(md 文件)创建文档应用程序。

要求维护这些 md 文件并将它们转换为 rst 格式(我使用的是 pandoc)。所以现在我有一个配置好的 Sphinx 应用程序,只有第一个文件。现在的问题是一些 rst 有指向 SVG 图像的链接,我必须使用 Sphinx 的乳胶生成器将它们转换为 PDF。

我四处搜索并找到了 2 年前的解决方案,这基本上就是我要找的:https://sites.google.com/site/nickfolse/home/sphinx-latexpdf-output-with-svg-images。我试图实现它,但我不是 GNU makefile 的专家,我不知道当前版本的 Sphinx 是否允许它,或者它是否有一个简单的解决方法,所以事情没有成功。

有人对此有可行的解决方案吗?

目前仍不支持 SVG。我通过将原始文件 (OmniGraffle) 导出到 SVG 和 PNG 来解决 Pyramid 文档中的问题。

docs/narr/router.rst中:

.. image:: ../_static/pyramid_request_processing.*

然后我们将图像放在 docs/_static

HTML uses SVG and the PDF uses PNG.

Sphinx SVG to PDF converter 扩展程序可以自动从 SVG 转换为 PDF。