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

Question

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

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

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

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

Answer 1

目前，尚不支持SVG。 我通过将原始文件（OmniGraffle）导出到SVG和PNG来解决金字塔文档中的问题。

在docs / narr / router.rst中 ：

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

然后将图像放置在docs / _static中 。

HTML使用SVG ， PDF使用PNG 。

Answer 2

可以使用Sphinx SVG to PDF 转换器扩展来自动从 SVG 转换为 PDF。