如何使用 pandoc 包含来自 epub 模板的图像？

Posted 2023-05-06

【中文标题】如何使用 pandoc 包含来自 epub 模板的图像？

【英文标题】：How to include images from the epub template with pandoc?

【发布时间】：2021-07-22 14:25:00

【问题描述】：

我已更改 epub 模板以显示更多信息。它工作正常，除非我指定引用本地文件的图像。例如<img src = "my_file.png">。代码在 epub 中，但图像文件没有。

【参考方案1】：

Pandoc 不会将模板解析为 html，因此在收集要包含在 EPUB 中的媒体元素时，它会丢失 <img> 元素。一个快速而简单的解决方法是在一些未使用的元数据字段中列出丢失的图像。例如，

---
missing-images: |
  ![](my_file.png)
---

将上述内容存储在一个文件中，并通过--metadata-file 将其传递给pandoc。这使 pandoc 知道该文件，并强制将其包含在内。

可以通过让 pandoc 解析模板并提取图像信息来自动化它，例如使用 pandoc Lua 过滤器，但这可能比它的价值更麻烦。