maven-pdf-plugin: как определить корень документа для использования относительных ссылок - PullRequest
Новая
       24

maven-pdf-plugin: как определить корень документа для использования относительных ссылок

0 голосов
/ 11 сентября 2018

Я использую maven-pdf-plugin для создания PDF-файла из документа уценки. У меня есть файл уценки в /src/site/markdown вместе с включенными файлами изображений. У меня есть pdf.xml файл в /src/site.

Когда я запускаю mvn pdf:pdf, я получаю файл PDF, сгенерированный в /target/pdf. Файл PDF отлично отформатирован из файла уценки, но не включает изображения. Вывод содержит ошибки, указывающие, что он не может найти изображения наиболее вероятно из-за предупреждения:

[warn] Корень документа не указан, локальные ссылки не будут обрабатываться правильно!

Я просмотрел все, что могу найти в maven-pdf-plugin, и не нашел ссылок на то, как установить этот неуловимый корень документа. Я хотел бы сохранить файлы изображений в том же каталоге и использовать относительные ссылки в файле уценки, то есть в этом случае ссылка - это просто имя файла.

Буду признателен за любую помощь или указатели, где найти то, что мне нужно сделать.

ИЗМЕНИТЬ, чтобы добавить pdf.xml Вот содержимое /src/site/pdf.xml

<document outputName="DesignDoc">
<meta>
  <title>Design Documentation</title>
  <author>Team A</author>
</meta>
<toc name="Table of Contents">
  <item name="Design Documentation" ref="DesignDoc.md"/>
</toc>
<cover>
  <coverTitle>${project.name}</coverTitle>
  <coverSubTitle>v. ${project.version}</coverSubTitle>
  <coverType>Design Documentation</coverType>
  <projectName>${project.name}</projectName>
</cover>
</document>

Файл уценки находится в /src/site/markdown. Файлы изображений, которые будут включены, находятся в том же каталоге.

Это пример того, как изображение включено в файл уценки:

![Domain Model](domain-model-placeholder.png)

РЕДАКТИРОВАТЬ, чтобы добавить результаты дальнейшего исследования
Два способа, которыми я могу создать PDF-файл с визуализированными изображениями, это либо поместить файлы изображений в корень проекта верхнего уровня, либо изменить спецификацию изображения в файле уценки, чтобы она была относительно корневой директории проекта. Первое - паршивое решение. Последнее может быть временным обходным путем, но может нарушить другой способ, которым мы используем файл уценки.

...