Как исправить сломанные ссылки подмодуля в Maven Site для многомодульного проекта?

Question

Я создаю Maven Сайт для 3 уровня мульти-модуль Maven проекта, который структурирован так:

parent 
    child-a 
     child-b 

Я бегу mvn site site:stage

The Maven модуль сайта ссылка работает для ребенка-а, но ломается для вложенного модуля child-b. (Ссылка на ребенка-б делает работу, если я первый нажмите на ссылку, чтобы ребенок-а.)

Смотрите сами здесь: http://justinhrobbins.github.io/multi-module-site-report-test/site/0.0.1-SNAPSHOT/

У меня есть следующие в моем родительском ПОМ:

<distributionManagement> 
    <site> 
     <id>site</id> 
     <name>site</name> 
     <url>scp://www.yourcompany.com/www/docs/project/</url> 
    </site> 
</distributionManagement> 

Что нужно сделать для того, чтобы ссылки работали для всех модулей проекта в этом отчете сайта Maven? (Я знаю, что <url> не реально, на данный момент я хочу работать в сцене)

Я добавил простой тест проект на Github, демонстрирующий вопрос: https://github.com/justinhrobbins/multi-module-site-report-test

EDIT: Я использую следующие версии плагина:

<maven.site.plugin.version>3.3</maven.site.plugin.version> 
<maven.project.info.reports.plugin.version>2.7</maven.project.info.reports.plugin.version> 

Answer 1

Я был в состоянии решить эту проблему, добавив <url> элемент в родительском пОМ. Я не понимаю, почему это исправит.

Перед добавлением <url> элемента Я видел это в журнале после запуска mvn site site:stage

[WARNING] No project URL defined - decoration links will not be relativized! 

После добавления элемента и повторного запуска команды Maven, журнал теперь показывает следующее:

[INFO] Relativizing decoration links with respect to project URL: 

модули в отчете сайта Maven теперь работают.

Главный филиал проекта образец GitHub был обновлен с решением

https://github.com/justinhrobbins/multi-module-site-report-test

Больше информации о цели <url> элемента можно найти здесь: https://maven.apache.org/plugins/maven-site-plugin/faq.html#Use_of_url