首页 > 解决方案 > 尝试创建 PDF 时出现 Sphinx/PlantUML 错误

问题描述

Fedora 盒子:

在过去的几个月里,我一直在使用 Sphinx 和 PlantUML,并且对它非常熟悉。特别是让它通过 HTML、PDF 和 DOCX 构建。但是我遇到了一个问题,希望大家能帮我解决。

目前,如果我使用 PlantUML 通过 .jar 文件渲染图像(并且只是将这个新图像作为链接包含在 .rst 文档中),Sphinx 构建这个项目没有问题。HTML、PDF、DOCX,没关系。文档已创建,图像已显示,一切正常。

对于 PDF,我使用的是 rst2pdf Sphinx 扩展。Confy.py 文件配置正确。

但是,如果我安装 PlantUML 插件(sphinxcontrib-plantuml-0.21.tar.gz),并通过 :: uml 在 .rst 文档中放入相同的代码(减去 @start/end),Sphinx 将在我通过 PDF 构建文件:

Warning: epstopdf command 'epstopdf' cannot be run

为了让我们清楚,当我通过 Make HTML 构建时,我没有收到这样的错误。HTML 完美地显示了一切。

很好。所以我在谷歌上搜索了那个错误消息,实际上我得到了另一个Stack Overflow 主题,它指向这个CTAN 站点以下载这个 epstopdf 文件

我再次运行构建命令,然后查看 PDF。我想要的图像在 _build/PDF 文件夹中,所以这是肯定的,但是当我打开 PDF 本身时,它会显示一个巨大的 FILE NOT FOUND 图片错误。

如何获得带有插件渲染的 Sphinx 文档来构建 PDF 文件然后显示图像?

谢谢你们

标签: python-sphinxplantumlrst2pdf

解决方案


推荐阅读