Sphinx 文档：通过 Latex 在 PDF 中包含 svg 图像

Question

我正在一家 IT 公司实习，该公司需要为其固件文档（md 文件）提供文档应用程序。

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

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

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

Answer 1

目前尚不支持 SVG。我在 Pyramid 文档中通过将原始文件 (OmniGraffle) 导出为 SVG 和 PNG 来解决它。

在docs/narr/router.rst:

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

我们将图片放在docs/_static。

HTML uses SVG 和 PDF uses PNG。

Answer 2

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