Почему плагин DITA Open Toolkit PDF переименовывает атрибуты изображения href?

Question

Извините, если этого недостаточно информации. Обычно я не обращаюсь за помощью в Интернете, как это.

Я использую DITA Open Toolkit 3.4 на Windows. Я сгенерировал плагин под названием «vcr2», используя Jarno (очень хороший и полезный) PDF Plugin Generator, а затем произвел несколько настроек. Плагин использует плагин pdf2 в качестве базы. Когда я пытаюсь использовать плагин vcr2, мои изображения не работают. Я отследил проблему до искаженных имен файлов изображений в атрибуте href изображения.

Например:

В моем исходном файле (задача DITA) выглядит разметка для одного из моих изображений как это:

<image href="MyRemindersChooseReminder.png"/>


Если я запускаю преобразование с плагином pdf2, изображения работают нормально. В объединенном файле stage1. xml в папке Temp, XML для того же изображения выглядит так:

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

Обрабатывается в файл Topi c .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"/>

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

Когда я отслеживаю это далее, кажется, что где-то в задаче Ant читателя карты это имя файла получает изменилось на эту криптированную c строку псевдо-шестнадцатеричного числа. Я думаю, что позже он должен быть изменен обратно или преобразован в полный URI или что-то в этом роде.

Итак, вопрос состоит из двух частей: Почему Open Toolkit меняет мои имена файлов и что должно меняться их обратно?

Answer 1

Препроцесс DITA-OT использует хэши для временных имен файлов, поскольку он позволяет коду не иметь дело со структурами каталогов. Это позволяет препроцессору работать в так называемом режиме map-first , где он сначала обрабатывает все ресурсы карты DITA и только затем начинает обрабатывать DITA topi c и ресурсы изображения.

Препроцесс имеет шаг под названием clean-preprocess , который может перезаписывать имена временных файлов в соответствии с именами файлов ресурсов источника. Однако эта операция перезаписи отключена для вывода в формате PDF, поскольку исходные имена файлов не используются ни для чего в этом типе вывода.