为什么 DITA Open Toolkit PDF 插件重命名图像 href 属性？

Question

如果这里没有足够的信息，我很抱歉。我通常不会像这样在网上寻求帮助。

我在 Windows 上使用 DITA Open Toolkit 3.4。我使用 Jarno（非常优秀和有用）的 PDF 插件生成器生成了一个名为“vcr2”的插件，然后进行了一些自定义。该插件使用 pdf2 插件作为基础。当我尝试使用 vcr2 插件时，我的图像无法正常工作。我已将问题追溯到图像的 href 属性中格式错误的图像文件名。

例如：

在我的源文件（DITA 任务）中，我的一张图片的标记如下所示：

<image href="MyRemindersChooseReminder.png"/>


如果我使用 pdf2 插件运行转换，图像可以正常工作。在 Temp 文件夹中合并的 stage1.xml 文件中，同一图像的 XML 如下所示：

<image class="- topic/image " href="df2d132af27436c59c5c8c4282e112d62bec8201.png" placement="inline" xtrc="image:1;10:66" xtrf="file:/V:/Vasont/Extract/t12340879-minimal/t12340879.xml"/>

处理成Topic.fo文件，如下所示：

<fo:external-graphic
 src="url('file:/V:/Vasont/Extract/t12340879-minimal/MyRemindersChooseReminder.png')"/>

一切正常，图像看起来也很好。

如果我通过我的 'vcr2' 插件运行相同的文件，它只是调用相同的 pdf2 插件并进行一些覆盖，所有图像都会损坏：

stage1.xml <image class="- topic/image " href="df2d132af27436c59c5c8c4282e112d62bec8201.png" placement="inline" xtrc="image:1;10:66" xtrf="file:/V:/Vasont/Extract/t12340879-minimal/t12340879.xml"/>

Topic.fo <fo:external-graphic
 src="url('file:/V:/Vasont/Extract/t12340879-minimal/df2d132af27436c59c5c8c4282e112d62bec8201.png')"
/>

随着我进一步追查，似乎在地图阅读器 Ant 任务的某个地方，这个文件名被更改为那个神秘的伪十六进制字符串。我认为稍后它应该被改回或解析为完整的 URI 或其他东西。

所以，问题分为两部分：为什么 Open Toolkit 会更改我的文件名，应该如何将它们改回来？

Answer 1

DITA-OT 的预处理使用哈希作为临时文件名，因为它允许代码不处理目录结构。这使得预处理可以在所谓的"map-first" mode 中工作，它首先处理所有 DITA 映射资源，然后才开始处理 DITA 主题和图像资源。

预处理有一个称为clean-preprocess的步骤，它可以重写临时文件名以匹配源资源文件名。但是，对于 PDF 输出禁用此重写操作，因为原始文件名不用于该输出类型中的任何内容。