使用Maven Site运行中的包含呈现AsciiDoctor doc

时间:2015-09-06 11:10:46

标签: maven maven-site-plugin asciidoctor

我使用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文件中使用相对包含?

1 个答案:

答案 0 :(得分:1)

路径应该与您正在运行maven的目录相关,除非自我们第一次添加在插件中生成网站的能力以来已经更改。您是否尝试过使用baseDirrelativeBaseDir属性?您可以阅读更多相关信息in the readme。如果它仍然无法正常工作,我会认为应该提交错误和问题。