Визуализация документа AsciiDoctor с включениями в Maven Site run

Question

Я использую плагин Maven Site для создания и включения документации на основе AsciiDoctor на наш сайт Maven. Это прекрасно работает, если исходный файл 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 атрибуты? Вы можете прочитать больше о них в файле readme. Если он все еще не работает, я считаю, что ошибка и проблема должны быть поданы.