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

问题描述

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

解决方法

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

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

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

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