在 Maven 站点运行中呈现包含包含的 AsciiDoctor 文档

Question

我使用 Maven 站点插件生成并在我们的 Maven 站点中包含基于 AsciiDoctor 的文档。如果 AsciiDoctor 源文件不包含任何其他 AsciiDoctor 文件，此方法工作正常。

但是如果我想包含任何其他文件，如下所示，AsciiDoctor 找不到 050-gitworkflow.adoc。

include::050-gitworkflow.adoc[]

相反，我可以看到 Maven 生成的以下消息

[INFO] --- maven-site-plugin:3.4:site (default-site) @ tamaya-all ---
[INFO] Parent project loaded from repository: org.apache:apache:pom:17
[WARNING] Unable to find a URL to the parent project. The parent menu will NOT be added.
[INFO] Relativizing decoration links with respect to project URL: http://tamaya.incubator.apache.org
[INFO] Rendering site with lt.velykis.maven.skins:reflow-maven-skin:jar:1.1.1 skin.
[INFO] Rendering 4 Doxia documents: 3 asciidoc, 1 markdown
asciidoctor: WARNING: <stdin>: line 20: include file not found: /Users/obf/apache/tamaya/devguide/050-gitworkflow.adoc

看来 AsciiDoctor 或假设文档的根目录与 Maven 模块基本目录相同。

如何在主 Asciidoctor 文件中使用相对包含？

Answer 1

该路径应该是相对于您运行 maven 所在目录的路径，除非自从我们首次在插件中添加生成站点的功能后该路径发生了变化。您是否尝试过使用 baseDir 或 relativeBaseDir 属性？您可以阅读更多关于它们的信息 in the readme。如果它仍然不起作用，我会认为应该提交错误和问题。

在 Maven 站点 运行 中呈现包含包含的 AsciiDoctor 文档

Rendering AsciiDoctor doc with includes within Maven Site run

maven

maven-site-plugin

asciidoctor

在 Maven 站点运行中呈现包含包含的 AsciiDoctor 文档