0

我使用 Maven Site 插件在我们的 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 文件中使用相对包含？

4

1 回答 1

1

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

于 2015-09-07T04:45:56.650 回答