maven-pdf-plugin：如何定义文档根目录以使用相对引用

Question

我正在使用maven-pdf-plugin从markdown文档生成PDF文件。我在/src/site/markdown中有markdown文件以及随附的图像文件。我在pdf.xml中有一个/src/site文件。

运行mvn pdf:pdf时，我得到/target/pdf中生成的PDF文件。 PDF文件的格式可以从Markdown文件中很好地格式化，但不包括图像。输出有错误，指示由于警告而无法找到图像：

[警告]未指定文档根目录，本地链接将无法正确解析！

我搜索了在maven-pdf-plugin上可以找到的所有内容，但没有找到有关如何设置此难以理解的文档根目录的参考。我想将图像文件保存在同一目录中，并在markdown文件中使用相对引用，即在这种情况下，引用只是文件名。

任何帮助或指向哪里可以找到我需要做的事情的人，将不胜感激。

编辑以添加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的两种方法是将图像文件放置在顶级项目根目录下，或者将markdown文件中的图像规范更改为相对于项目根目录。前者是一个糟糕的解决方案。后者可能是暂时的解决方法，但会破坏我们使用markdown文件的其他方式。